在PhotonOS的Docker中运行SymmetricDS启动失败问题排查

云上老周

2026-7-3

解决SymmetricDS Docker镜像启动提示找不到engine *.properties文件的问题

核心原因

jumpmind/symmetricds镜像本身不包含默认的引擎配置文件，它依赖用户挂载自定义的*.properties配置文件到容器内指定路径，否则启动时会因缺少必要的引擎配置而终止进程。

必须补充的配置项与操作步骤

挂载自定义引擎配置文件：

在本地创建SymmetricDS配置目录，例如./symmetric-config

在该目录下创建引擎配置文件（如my-engine.properties），至少需要包含以下核心配置项：

# 数据库连接配置
db.driver=com.mysql.cj.jdbc.Driver
db.url=jdbc:mysql://你的数据库地址:3306/symmetric?useSSL=false&allowPublicKeyRetrieval=true
db.user=数据库用户名
db.password=数据库密码
# 引擎节点基础配置
engine.name=自定义引擎名称
group.id=节点组ID
external.id=节点唯一标识
registration.url=http://注册节点地址:31415/sync/节点组ID

启动容器时通过-v参数将本地配置目录挂载到容器内的/opt/symmetric-ds/engines路径：
```
docker run -d -p 31415:31415 -v ./symmetric-config:/opt/symmetric-ds/engines jumpmind/symmetricds
```

可选：通过环境变量自动生成配置
如果不想手动编写properties文件，可通过环境变量传递核心配置，镜像会自动生成对应的engine配置文件：

docker run -d -p 31415:31415 \
  -e DB_DRIVER=com.mysql.cj.jdbc.Driver \
  -e DB_URL=jdbc:mysql://你的数据库地址:3306/symmetric?useSSL=false \
  -e DB_USER=数据库用户名 \
  -e DB_PASSWORD=数据库密码 \
  -e ENGINE_NAME=自定义引擎名称 \
  -e GROUP_ID=节点组ID \
  -e EXTERNAL_ID=节点唯一标识 \
  jumpmind/symmetricds