如何用fdroidserver一键搭建专属F-Droid仓库？避开95%新手坑

1
# Debian/Ubuntu系统
2
sudo apt-get update
3
sudo apt-get install fdroidserver nginx git python3-venv openjdk-11-jdk
4

5
# Fedora系统
6
sudo dnf install fdroidserver nginx git python3 java-11-openjdk-devel
7

8
# Arch Linux
9
sudo pacman -S fdroidserver nginx git python jdk11-openjdk

1
# Ubuntu/Mint使用官方PPA
2
sudo add-apt-repository ppa:fdroid/fdroidserver
3
sudo apt-get update
4
sudo apt-get install fdroidserver
5

6
# Debian使用backports
7
sudo apt-get install -t bookworm-backports fdroidserver
8

9
# 其他发行版查看对应包管理器命令

1
# 创建Python虚拟环境
2
python3 -m venv fdroidserver-env
3
source fdroidserver-env/bin/activate
4

5
# 从GitLab安装最新版本
6
pip install git+https://gitlab.com/fdroid/fdroidserver.git

1
# 拉取官方镜像
2
docker pull registry.gitlab.com/fdroid/fdroidserver:latest
3

4
# 或使用可执行镜像（推荐用于部署）
5
docker pull registry.gitlab.com/fdroid/fdroidserver:buildserver

1
# 安装nginx
2
sudo apt-get install nginx
3

4
# 配置网站根目录（根据实际情况调整）
5
sudo mkdir -p /var/www/fdroid
6
sudo chown -R $USER:$USER /var/www/fdroid

1
# 在网站根目录下创建fdroid子目录
2
cd /var/www/fdroid
3

4
# 初始化仓库（生成签名密钥）
5
fdroid init

1
# 使用keytool生成2048位RSA密钥
2
keytool -genkey -v \
3
  -keystore my-keystore.jks \
4
  -alias my-repo-key \
5
  -keyalg RSA \
6
  -keysize 2048 \
7
  -validity 10000
8

9
# 设置密钥密码（提示输入两个密码）
10
# 1. Keystore密码（密钥库访问密码）
11
# 2. Key密码（密钥本身密码）

1
keystore: my-keystore.jks            # 密钥库文件路径
2
repo_keyalias: my-repo-key        # 密钥别名
3
keystorepass: $FDROID_KEYSTORE_PASS  # 使用环境变量
4
keypass: $FDROID_KEY_PASS         # 使用环境变量

1
# 在~/.bashrc或~/.profile中添加
2
export FDROID_KEYSTORE_PASS="your_strong_password"
3
export FDROID_KEY_PASS="your_strong_password"
4

5
# 或在命令前临时设置
6
FDROID_KEYSTORE_PASS="password" fdroid update

1
# 直接复制已签名的APK文件
2
cp /path/to/myapp-release.apk repo/
3

4
# 生成索引
5
fdroid update

1
# 1. 创建应用元数据文件
2
cp templates/general.yml metadata/com.example.app.yml
3

4
# 2. 编辑元数据文件（参考Build Metadata Reference）
5
nano metadata/com.example.app.yml
6

7
# 3. 构建应用
8
fdroid build com.example.app -v
9

10
# 4. 更新索引
11
fdroid update

1
Summary:
2
  en-US: A simple puzzle game
3
  zh-CN: 简单益智游戏
4
  de-DE: Einfaches Puzzle-Spiel
5

6
Description:
7
  en-US: |-
8
    This game challenges players to solve increasingly
9
    difficult puzzles in a beautiful environment.
10
  zh-CN: |-
11
    这个游戏挑战玩家在美丽环境中解决越来越难的谜题。
12
  de-DE: |-
13
    Dieses Spiel fordert die Spieler, Rätsel in einer
14
    schönen Umgebung zu lösen.

1
# 1. 删除APK文件
2
rm repo/com.example.app_*.apk
3

4
# 2. 删除元数据文件（可选）
5
rm metadata/com.example.app.yml
6

7
# 3. 更新索引（应用会自动从索引中移除）
8
fdroid update
9

10
# 4. 发布更新
11
fdroid deploy

1
# 1. 设置存档策略
2
# 在config.yml中设置：
3
archive_older: 3  # 主仓库保留最新3个版本
4

5
# 2. 运行更新命令
6
fdroid update
7

8
# 旧版本会自动移动到archive/目录

1
https://your-domain.com/fdroid/repo/

1
https://your-domain.com/fdroid/repo?fingerprint=SHA256_FINGERPRINT_HERE

1
# 从keystore中提取公钥指纹
2
keytool -list -v -keystore keystore.p12 | grep SHA256

1
https://your-domain.com/fdroid/repo/add

1
# 使用fdroid命令生成二维码
2
fdroid gpgsign --qrcode
3

4
# 二维码会保存为fdroid/qrcode.png

1
# 设置cronjob自动更新
2
# 编辑crontab
3
crontab -e
4

5
# 添加以下行（每小时更新一次）
6
0 * * * * cd /var/www/fdroid && fdroid update && fdroid deploy >> /var/log/fdroid-updates.log 2>&1

1
# 检查仓库完整性
2
fdroid checkupdates --all
3

4
# 验证签名
5
fdroid gpgsign --verify
6

7
# 检查元数据格式
8
fdroid lint --all

1
# 添加到crontab（每天凌晨2点备份）
2
0 2 * * * /path/to/backup-fdroid.sh

1
# 在config.yml中设置
2
repo_maxage: 7  # 索引最大有效期（天）

1
# 生成增量更新文件
2
fdroid update --make-diff
3

4
# 减少客户端下载流量

1
# 自动压缩图标（减少文件大小）
2
fdroid update --icons-compress

1
# 限制配置文件和密钥的访问权限
2
chmod 600 keystore.p12
3
chmod 600 config.yml
4
chown www-data:www-data /var/www/fdroid/repo

1
# 获取Let's Encrypt免费证书
2
sudo certbot --nginx -d your-domain.com
3

4
# 配置自动续期
5
sudo certbot renew --dry-run

1
# 在nginx配置中添加
2
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
3
add_header X-Content-Type-Options "nosniff" always;
4
add_header X-Frame-Options "DENY" always;
5
add_header Content-Security-Policy "default-src 'self'" always;

1
# 创建日志目录
2
mkdir -p /var/log/fdroid
3

4
# 配置fdroid使用日志
5
fdroid update >> /var/log/fdroid/update.log 2>&1
6
fdroid deploy >> /var/log/fdroid/deploy.log 2>&1

1
CRITICAL: 'repo_keyalias' not found in config.yml!
2
CRITICAL: 'keystorepass' not found in config.yml!
3
CRITICAL: 'keypass' not found in config.yml!

1
# 重新初始化仓库（会自动生成正确的密钥配置）
2
rm config.yml keystore.p12
3
fdroid init
4

5
# 或手动配置缺失字段
6
# 编辑config.yml，添加：
7
repo_keyalias: "fdroid-repo-key"
8
keystore: "keystore.p12"
9
keystorepass: "your_password"
10
keypass: "your_password"

1
ERROR: Can't sign because the keystore doesn't exist

1
WARNING: Non-free library detected: com.google.android.gms

1
# 在元数据文件中标记AntiFeatures
2
AntiFeatures:
3
  - NonFreeNet
4
  - Tracking
5

6
# 添加到描述中说明
7
Description: |-
8
  This app uses Google Play Services.
9
  It requires microG for full functionality.

1
ERROR: Signature verification failed for com.example.app

1
# 验证APK签名
2
jarsigner -verify -verbose -certs myapp.apk
3

4
# 重新签名APK（如有原始密钥）
5
jarsigner -keystore your-keystore.jks \
6
  -signedjar signed-app.apk \
7
  myapp.apk your-alias
8

9
# 使用密钥库中的密钥
10
jarsigner -keystore keystore.p12 \
11
  -storepass $FDROID_KEYSTORE_PASS \
12
  -keypass $FDROID_KEY_PASS \
13
  -signedjar signed-app.apk \
14
  myapp.apk repo_keyalias

1
WARNING: Requested API level 35 is larger than maximum we have

1
# 更新androguard到最新版本
2
pip install --upgrade androguard
3

4
# 或从backports安装
5
apt-get install -t bookworm-backports androguard

1
Failed to fetch repo metadata
2
java.net.UnknownHostException: your-domain.com

1
# 检查DNS解析
2
nslookup your-domain.com
3

4
# 检查防火墙规则
5
sudo ufw status
6
sudo ufw allow 80/tcp
7
sudo ufw allow 443/tcp
8

9
# 检查nginx配置
10
sudo nginx -t
11
sudo systemctl restart nginx
12

13
# 检查SSL证书
14
openssl s_client -connect your-domain.com:443 -servername your-domain.com

1
Downloading index... (very slow)

1
# 启用gzip压缩（nginx默认启用）
2
gzip on;
3
gzip_types text/plain application/json application/xml;
4

5
# 设置正确的缓存头
6
location /fdroid/repo/ {
7
    expires 1h;
8
    add_header Cache-Control "public, immutable";
9
}
10

11
# 使用CDN加速（可选）
12
# 将仓库文件上传到CDN服务

1
Multiple versions of com.example.app available

1
App not showing as update available

1
# 检查versionCode是否正确递增
2
# 确保新版本的versionCode大于已安装版本
3

4
# 更新元数据文件中的版本信息
5
CurrentVersion: '2.1'
6
CurrentVersionCode: 21
7

8
# 重新生成索引
9
fdroid update
10

11
# 在客户端中强制刷新仓库
12
# 下拉刷新界面

1
/var/www/fdroid: No space left on device

1
# 清理旧版本APK文件
2
fdroid update --archive
3

4
# 手动清理
5
find repo/ -name "*.apk" -mtime +180 -delete
6

7
# 压缩旧版本
8
cd archive/
9
gzip *.apk
10

11
# 设置存档策略
12
archive_older: 1  # 只保留最新版本

1
APK file size: 50MB (too large)

1
App icon not showing in client

1
# 确保图标文件存在
2
ls repo/icons/
3

4
# 手动添加图标
5
cp /path/to/icon-64x64.png repo/icons/com.example.app_64x64.png
6
cp /path/to/icon-192x192.png repo/icons/com.example.app_192x192.png
7

8
# 更新索引
9
fdroid update

1
App description not showing
2
Screenshots missing

1
# 检查元数据文件中的描述字段
2
Description: |-
3
  Your app description here...
4

5
# 添加截图
6
mkdir -p repo/icons/com.example.app/en-US/phoneScreenshots/
7
cp /path/to/screenshot1.png repo/icons/com.example.app/en-US/phoneScreenshots/1.png
8
cp /path/to/screenshot2.png repo/icons/com.example.app/en-US/phoneScreenshots/2.png
9

10
# 更新索引
11
fdroid update

1
# 为特定应用创建单独仓库
2
mkdir -p subrepos/enterprise-app
3
cd subrepos/enterprise-app
4
fdroid init
5

6
# 配置独立的密钥和URL

1
# 安装node_exporter
2
wget https://github.com/prometheus/node_exporter/releases/download/v1.3.1/node_exporter-1.3.1.linux-amd64.tar.gz
3
tar xvfz node_exporter-1.3.1.linux-amd64.tar.gz
4
./node_exporter &