snw35/ffsync

ffsync Docker镜像

镜像概述

本镜像提供Firefox Sync Server的容器化部署方案，大幅简化自托管Firefox同步服务的搭建流程。默认使用SQLite数据库即可直接运行，同时支持MySQL/MariaDB和Postgres数据库配置，满足不同场景需求。

核心功能

• 自托管Firefox同步服务，避免数据存储在第三方服务器
• 支持SQLite、MySQL/MariaDB、Postgres多种数据库
• 容器化设计，易于管理与迁移
• 提供详细配置指南，适配个人及家庭使用场景

使用场景

• 隐私敏感用户：将书签、密码、历史记录等数据存储在自有服务器
• 技术爱好者：搭建私有同步服务，学习容器化部署与配置
• 家庭支持：为非技术用户提供稳定同步方案，解决设备更换数据丢失问题

配置说明

运行容器

容器暴露5000端口，启动命令如下：

bash
docker run -dit --name ffsync -p 5000:5000 --mount source=ffsync,target=/data snw35/ffsync:latest

访问http://localhost:5000/token/1.0/sync/1.5显示"It works!"表示服务正常。

修改基础配置

1. 进入容器：docker exec -it ffsync sh
2. 编辑配置文件：vi /data/syncserver.ini
3. 修改public_url为实际访问地址，设置secret值增强安全性
4. 重启容器生效：docker restart ffsync

切换数据库

若使用MySQL/MariaDB或Postgres，修改sqluri：

• Postgres示例：sqluri = "postgres://username:password@hostname:5432/databasename"
• MySQL示例：sqluri = "mysql://username:password@hostname:3306/databasename" 确保同步服务与数据库容器在同一Docker网络。

设备配置步骤

1. Firefox输入about:config，搜索identity.sync.tokenserver.uri
2. 修改值为https://your.domain/token/1.0/sync/1.5（替换为实际域名）
3. 重新登录Firefox账户，完成跨设备同步

永久设置（Linux）

创建/etc/firefox/pref/prefs.js避免设置重置：

javascript
user_pref("identity.sync.tokenserver.uri", "[***]");