morgenroth/mozilla-syncserver

自托管Firefox同步服务器

镜像概述

这是一个一体化的自托管Firefox同步服务器包，集成了用于认证的tokenserver项目和用于数据存储的syncstorage项目，可作为独立Web应用运行，替代默认的Mozilla托管同步服务。

核心功能

• 支持Firefox浏览器数据同步（书签、历史记录、密码、扩展等）
• 提供灵活的自定义配置选项
• 兼容SQLite、MySQL、PostgreSQL等多种数据库后端
• 支持Docker容器化部署，便于快速搭建

使用场景

• 个人用户：掌控同步数据隐私，避免依赖第三方服务
• 企业/组织：内部部署统一的同步服务，管理员工浏览器数据
• 开发测试：在独立环境中验证同步功能

配置说明

通过编辑syncserver.ini文件进行自定义配置，关键选项包括：

• public_url：客户端可见的服务器主机名
• sqluri：数据库连接URI（如sqlite:////data/syncserver.db）
• secret：用于签名认证令牌的随机密钥（需替换为强随机值）

Docker部署示例

构建镜像

bash
docker build -t syncserver:latest .

临时运行（测试用）

bash
docker run --rm \
  -p 5000:5000 \
  -e SYNCSERVER_PUBLIC_URL=http://localhost:5000 \
  -e SYNCSERVER_SECRET=<生成的随机密钥> \
  -e SYNCSERVER_SQLURI=sqlite:////tmp/syncserver.db \
  -e SYNCSERVER_BATCH_UPLOAD_ENABLED=true \
  -e SYNCSERVER_FORCE_WSGI_ENVIRON=false \
  -e PORT=5000 \
  syncserver:latest

持久化部署

bash
docker run -d \
  -v /syncserver:/data \
  -p 5000:5000 \
  -e SYNCSERVER_PUBLIC_URL=http://localhost:5000 \
  -e SYNCSERVER_SECRET=<生成的随机密钥> \
  -e SYNCSERVER_SQLURI=sqlite:////data/syncserver.db \
  -e SYNCSERVER_BATCH_UPLOAD_ENABLED=true \
  -e SYNCSERVER_FORCE_WSGI_ENVIRON=false \
  -e PORT=5000 \
  syncserver:latest

注意：确保本地目录/syncserver的所有者为1001:1001，以避免权限问题。

检查运行状态：

bash
/usr/local/bin/python -m syncstorage.tests.functional.test_storage \
  --use-token-server http://localhost:5000/token/1.0/sync/1.5