brantje/docker-firefox-syncserver

Firefox SyncServer

基于Alpine Linux的轻量、安全Firefox同步服务器容器

什么是Firefox SyncServer？

这是一个一站式自托管Firefox同步服务器包，集成了用于认证的"tokenserver"项目和用于存储的"syncstorage"项目，形成独立的Web应用。服务源码仓库可参考https://github.com/mozilla-services/syncserver%E3%80%82

容器目标

本容器旨在简化部署流程：无需卷存储（浏览器在服务 downtime 时保留数据），并尽可能保证安全性。

核心功能

• 基于Alpine Linux，体积轻量
• 以非root用户运行，提升安全性
• 无复杂配置或卷依赖，部署简单

运行时变量

• URL：浏览器访问的服务地址，例如：[***]
• FORCE_WSGI（可选）：设置为"true"以解决公网URL与应用内部URL不匹配的问题
• UID（可选）：运行服务器的用户ID
• GID（可选）：运行服务器的组ID

端口

• 5000

部署步骤

构建镜像

bash
git clone https://github.com/brantje/docker-firefox-syncserver
cd docker-firefox-syncserver
docker build -t sync .

运行容器

bash
docker run -d -p 5000:5000 -e URL=https://sync.example.com --name sync sync

Firefox配置

1. 打开Firefox，进入about:config页面
2. 搜索identity.sync.tokenserver.uri偏好设置
3. 将值修改为：https://sync.example.com:5000/token/1.0/sync/1.5
4. 若已登录Firefox账号，需登出并重新登录使设置生效

NGINX代理示例

nginx
server {
    server_name example.com;
    location / {
        proxy_pass http://localhost:5000/;
        proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        proxy_redirect off;
        proxy_buffering off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    listen 443 ssl; # 由Certbot管理
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 由Certbot管理
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 由Certbot管理
    include /etc/letsencrypt/options-ssl-nginx.conf; # 由Certbot管理
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # 由Certbot管理
}