urmelausmall/syncstoragersdocker Docker 镜像 - 轩辕镜像

Firefox Sync Server (MySQL连接版)

镜像概述

该Docker镜像提供了一个支持MySQL数据库连接的Firefox Sync服务器，用于搭建私有Firefox浏览器数据同步服务。用户可通过此服务器安全同步Firefox浏览器的书签、历史记录、密码等数据，实现数据私有管理与自主控制。

核心功能与特性

• MySQL数据库支持：采用MySQL数据库存储同步数据，提升数据可靠性与可维护性
• 用户容量管控：可配置最大用户数量限制（SYNC_CAPACITY），适配不同规模使用场景
• 安全加密机制：通过主密钥（SYNC_MASTER_SECRET）和 metrics 哈希密钥（METRICS_HASH_SECRET）保障数据传输与存储安全
• 灵活部署配置：支持自定义同步服务访问URL（SYNC_URL），适配不同网络环境需求

使用场景

• 个人用户搭建私有数据同步服务，避免数据存储于公共服务器
• 企业/组织内部部署，统一管理员工浏览器数据同步，保障数据隐私
• 对数据主权有严格要求的场景，替代Firefox官方同步服务

使用方法与配置说明

Docker Compose部署示例

推荐使用Docker Compose进行部署，以下为完整配置示例：

yaml
services:
  syncserver:
    container_name: firefox_syncserver
    image: docker.io/urmelausmall/syncstoragersdocker:latest
    restart: always  # 服务异常时自动重启
    ports:
      - "8000:8000"  # 宿主机端口:容器端口，可根据需求修改宿主机端口
    environment:
      LOGLEVEL: info  # 日志级别，可选值：debug, info, warning, error
      SYNC_URL: [***]  # 客户端连接同步服务器的URL，需替换为实际可访问地址
      SYNC_CAPACITY: 10  # 最大允许的用户数量，根据实际需求调整
      # 主密钥：使用以下命令生成随机字符串：cat /dev/urandom | base32 | head -c64
      SYNC_MASTER_SECRET: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      # Metrics哈希密钥：使用以下命令生成随机字符串：cat /dev/urandom | base32 | head -c64
      METRICS_HASH_SECRET: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      # SyncStorage数据库连接URL，替换为实际MySQL凭据（user:密码@主机:端口/数据库名）
      SYNC_SYNCSTORAGE_DATABASE_URL: mysql://user:pw@127.0.0.1:3306/ff_syncstorage
      # TokenServer数据库连接URL，替换为实际MySQL凭据
      SYNC_TOKENSERVER_DATABASE_URL: mysql://user:pw@127.0.0.1:3306/ff_tokenserver

环境变量配置说明

部署前置条件

1. MySQL数据库准备：

   • 需提前部署MySQL服务（独立部署或Docker容器）
   • 创建两个数据库：ff_syncstorage和ff_tokenserver
   • 确保Sync Server容器可访问MySQL服务（若MySQL在宿主机，建议使用宿主机IP而非127.0.0.1，或配置Docker网络互通）

2. 密钥生成： 执行以下命令生成SYNC_MASTER_SECRET和METRICS_HASH_SECRET：

   bash
   cat /dev/urandom | base32 | head -c64  # 生成64位随机密钥
   

3. 端口与网络：

   • 确保宿主机8000端口（或自定义端口）未被占用
   • 若需通过互联网访问，需配置端口转发及域名解析（推荐配合HTTPS使用）

启动与验证

1. 将上述Docker Compose配置保存为docker-compose.yml
2. 执行以下命令启动服务：

   bash
   docker-compose up -d
   

3. 查看服务状态：

   bash
   docker-compose ps  # 检查容器运行状态
   docker-compose logs -f  # 查看实时日志，验证服务启动正常
   

服务启动后，在Firefox浏览器中配置自定义同步服务器地址为SYNC_URL，即可使用私有同步服务。