arwynfr/arma3sync

arma3sync-docker 镜像文档

镜像概述和主要用途

arma3sync-docker提供以Docker容器形式运行的Arma3Sync软件，用于管理Arma 3游戏模组的同步和仓库管理。Arma3Sync是一款专业的Arma 3模组同步工具，支持仓库创建、模组版本控制及客户端同步等功能，本镜像将其封装为容器化应用，简化部署流程并提高环境一致性。

标签说明

⚠️ 生产环境使用时，应仅使用 arwynfr/arma3sync:1.7.107-jre8

arma3sync-docker提供多个标签，对应不同版本的Arma3Sync软件和Java运行时组合。可通过标签指定Arma3Sync的补丁版本和JRE的主要版本。完整标签列表可在https://hub.docker.com/r/arwynfr/arma3sync/tags%E6%9F%A5%E7%9C%8B%E3%80%82

Arma3Sync版本

镜像支持以下Arma3Sync版本：

• 1.1.23, 1.1.24, 1.1.30
• 1.2.37, 1.2.38, 1.2.39, 1.2.40, 1.2.45, 1.2.46, 1.2.47, 1.2.48
• 1.3.49
• 1.4.53, 1.4.61, 1.4.63
• 1.5.73, 1.5.75, 1.5.84
• 1.7.99, 1.7.101, 1.7.103, 1.7.104, 1.7.106, 1.7.107

💡 Arma3Sync 1.6版本不可用，因其依赖Java EE组件，而该组件在较新版本JRE中已移除。

OpenJDK版本

镜像支持以下OpenJDK运行时版本：

• jre8：Arma3Sync开发者推荐版本
• jre17：当前LTSC（长期支持）版本
• jre21：当前最新版本

卷说明

/data

Arma3Sync的核心数据存储目录，包含仓库配置、变更日志及版本信息。该目录在Dockerfile中被定义为卷，确保数据可持久化存储于容器外部，避免容器重启导致数据丢失。

/mods

模组文件存储目录，不属于应用核心数据，未被默认定义为卷。可通过挂载卷实现与其他容器（如Web服务器）的数据共享，或通过扩展镜像将模组文件直接集成到子镜像中。

环境变量配置

通过环境变量可实现仓库的自动初始化，需配置以下变量：

ARMA3SYNC_NAME

• 功能：定义容器启动时创建的仓库名称
• 特性：每次启动时自动创建（若不存在），需为有效标识符，可用于-build等命令
• 注意：为空时将跳过仓库创建流程

ARMA3SYNC_PROTOCOL

• 功能：指定仓库数据传输协议
• 取值范围：FTP、HTTP或HTTPS（大小写敏感）

ARMA3SYNC_URL

• 功能：仓库远程访问URL（含协议）
• 示例：http://www.sonsofexiled.fr/repository
• 说明：客户端通过此URL下载数据，自动配置文件路径为${ARMA3SYNC_URL}/.a3s/autoconfig

ARMA3SYNC_PORT

• 功能：客户端连接仓库的端口
• 特性：为空时自动使用协议默认端口（HTTP:80，HTTPS:443，FTP:21）

ARMA3SYNC_LOGIN 和 ARMA3SYNC_PASSWD

• 功能：仓库访问认证凭据
• 配置：需要认证时填写对应值；***访问时设为空值（无需设置为"anonymous"）

ARMA3SYNC_PATH

• 功能：本地模组文件存储路径
• 默认值：/mods
• 说明：需为绝对路径

使用示例

基本部署命令

bash
docker run -d \
  --name arma3sync \
  -v ./arma3sync-data:/data \  # 持久化存储仓库数据
  -v ./local-mods:/mods \      # 挂载本地模组目录
  -e ARMA3SYNC_NAME="MyArmaRepo" \
  -e ARMA3SYNC_PROTOCOL="HTTP" \
  -e ARMA3SYNC_URL="http://your-server.com/arma3-repo" \
  -e ARMA3SYNC_PORT="8080" \
  arwynfr/arma3sync:1.7.107-jre8

docker-compose配置示例

yaml
version: '3'
services:
  arma3sync:
    image: arwynfr/arma3sync:1.7.107-jre8
    container_name: arma3sync
    volumes:
      - ./data:/data
      - ./mods:/mods
    environment:
      - ARMA3SYNC_NAME=Arma3ServerRepo
      - ARMA3SYNC_PROTOCOL=HTTPS
      - ARMA3SYNC_URL=[***]
      - ARMA3SYNC_LOGIN=repo-user
      - ARMA3SYNC_PASSWD=secure-password
    restart: unless-stopped