需部署sync-1.5 server与auth-server，配置firefox客户端指向私有服务地址，并通过桌面端注册、密钥一致性验证，实现完全本地可控的加密同步。
如果您希望将火狐浏览器的同步数据完全掌控在本地，避免上传至 Mozilla 官方服务器，则需配置自建 Firefox Sync 私有本地同步服务器。该方案依赖于独立部署的 Sync-1.5 Server 与配套认证服务（auth-server），所有加密传输、账户验证与数据存储均发生在您指定的私有环境中。以下是具体配置步骤：
一、部署 Sync-1.5 Server 与 auth-server
Sync-1.5 Server 提供数据同步接口，auth-server 负责账户注册、登录与凭证签发；二者必须同时运行且相互可信，否则客户端无法完成身份认证与令牌获取。服务器需基于 Python 环境，支持 SQLite、MySQL 或 PostgreSQL 数据库。
1、在服务器上安装 Python 2.7 或兼容的 Python 3.x 运行时（依据所选 Sync-1.5 Server 版本要求）。
2、克隆或下载官方维护的 Sync-1.5 Server 代码仓库，解压后进入目录。
3、编辑 syncserver.ini 配置文件，设置 public_url 为可被客户端访问的完整 HTTPS 地址（例如 https://sync.yourdomain.com）。
4、配置 sqluri 参数，指定数据库类型与连接字符串（如 sqlite:///var/db/sync.db 或 mysql+pymysql://user:pass@localhost/sync）。
5、部署并启动 auth-server，确保其监听地址可通过局域网访问，且与 Sync-1.5 Server 共享同一域名根证书或启用 CORS 白名单。
二、使用 Docker 快速部署 SyncServer（替代方案）
Docker 方式提供环境隔离性与部署一致性，无需手动处理 Python 依赖与系统库冲突，适合快速验证与轻量级私有部署。
1、执行 docker build -t syncserver:latest . 构建镜像（需先获取官方或可信 fork 的源码）。
2、运行容器，关键环境变量必须显式传入：SYNCSERVER_PUBLIC_URL、SYNCSERVER_SECRET（使用 openssl rand -base64 32 生成）、SYNCSERVER_SQLURI。
3、通过 -v /本地目录:/data 挂载持久化卷，确保 SQLite 数据库文件不随容器销毁而丢失。
4、确认容器日志中输出 Listening on http://0.0.0.0:5000 且无数据库连接错误。
三、配置 Firefox 客户端指向自建服务
客户端必须显式覆盖默认的账户自动发现与令牌服务地址，否则仍会回退至 Mozilla 公共基础设施。所有修改均通过 about:config 强制生效，不依赖 UI 设置项。
1、在 Firefox 地址栏输入 about:config，确认风险提示后进入高级配置页面。
在 Linux 上通过 Chrome 挂载/VNC 自动发布小红书长笔记。Agent 撰写标题和正文后执行 xhs_publish.sh --publish --submit，触发小红书发布。
2、搜索并双击修改 identity.fxaccounts.autoconfig.uri，将其值设为 auth-server 的根地址（例如 https://auth.yourdomain.com）。
3、搜索并双击修改 identity.sync.tokenserver.uri，将其值设为 Sync-1.5 Server 的令牌端点（例如 https://sync.yourdomain.com/token/1.0/sync/1.5）。
4、搜索并双击修改 identity.sync.username（若存在），清空其值以避免缓存冲突。
5、关闭所有 Firefox 窗口，重新启动浏览器使配置加载生效。
四、在桌面端完成账户注册与登录
首次使用自建服务时，Firefox 不再复用 Mozilla 公共账户体系，必须通过 auth-server 提供的新注册流程创建独立账户。注册过程全程离线可控，邮箱仅用于账户标识，不触发第三方通信。
1、在已配置完成的 Firefox 中，点击右上角菜单 → 登录到 Firefox。
2、在登录页点击 创建账户，填写邮箱与密码，提交后跳转至 auth-server 注册界面。
3、在 auth-server 页面完成邮箱验证（验证链接发往本地邮件服务器或手动模拟 SMTP 回调）。
4、验证成功后，Firefox 自动完成登录，并显示“同步已开启”状态。
五、验证同步功能与密钥一致性
同步加密密钥独立于登录密码，用于端到端保护密码、地址簿等敏感字段。若密钥未统一或损坏，将导致跨设备解密失败，表现为密码项同步为空或历史记录缺失。
1、在任意已登录设备的 Firefox 中，进入 设置 → Firefox 账户 → 同步设置 → 管理同步加密密钥。
2、点击 查看当前密钥，确认所有设备显示的密钥字符串完全一致（区分大小写与空格）。
3、若发现不一致，点击 重置密钥，系统将强制所有设备重新下载加密数据包。
4、在任一设备地址栏输入 about:sync-log，点击 重新同步所有数据，观察日志末尾是否出现 Sync completed successfully 及各数据类型状态均为 OK。
