Docker 部署
校对日期:2026-11-06。适用于社区版及全部商业版(多站点需商业版标准版,演示审核流程需商业版基础版)。
镜像里已经带有 Java 运行环境、字体和数据库驱动。用 Jar 或 war 安装包部署见 Jar 部署、 Tomcat 部署;安装向导与无人值守清单本身的说明见安装向导与无人值守安装。
一、启动
执行 docker compose up -d --build 即可创建可访问的演示站(见根目录 compose.yaml)。
设置了 UJCMS_ 时,容器首次启动按环境变量自动完成安装(见下一节)。不设时为交互安装:容器启动后访问 /cp/, 通过安装向导完成安装;安装令牌见 docker logs 或容器内的 /ujcms/(或以 UJCMS_ 预设)。
二、用环境变量配置安装
环境变量按 Spring 宽松绑定直接映射无人值守清单的键,常用变量:
| 环境变量 | 对应清单键 | 示例 |
|---|---|---|
UJCMS_ | ujcms. | true |
UJCMS_ | …admin.username | admin |
UJCMS_ | …admin.password | 建议通过 Secret 注入 |
UJCMS_ | …sites[0].name | UJCMS演示站 |
UJCMS_ | …sites[0]. | https |
UJCMS_ | …sites[0]. | demo.ujcms.com |
UJCMS_ | …sites[0]. | bundled |
UJCMS_ | …sites[0]. | all / none |
UJCMS_ | …sites[1].name | English Site(第 2 条起需商业版标准版) |
UJCMS_ | …sites[1].lang | en(语言变体,与 _LANGOF 成对) |
UJCMS_ | …sites[1]. | UJCMS演示站(按站点名称加入语言组) |
UJCMS_ | …sites[1]. | en(子目录寻址 /en/;任意条目可用) |
UJCMS_ | …sites[1]. | library(库中已有的主题包,含从 LIBRARYDIR 导入的包) |
UJCMS_ | …sites[1]. | journal(包内 theme. 的 themeName[@版本]) |
UJCMS_ | …library-dir | /ujcms/ |
UJCMS_ | 无(容器入口脚本处理,非清单键) | true(演示站:换镜像后首次启动用镜像内置主题覆盖已安装的同名主题实例,见“主题随镜像更新”) |
UJCMS_ | …users[0]. | demo |
UJCMS_ | …users[0]. | 建议通过 Secret 注入 |
UJCMS_ | …users[0]. | true(配合 UJCMS_DEMO=true) |
UJCMS_DEMO | ujcms.demo(非清单键) | true(演示站只读拦截:后台对 ID 10 账号强制仅 GET) |
UJCMS_ | …users[0]. | 管理角色 |
UJCMS_ | …demo.workflow | true(商业版基础版起;社区版自动跳过) |
UJCMS_ | …demo. | true |
UJCMS_ | …register. | true(开启会员注册;第三方登录的新用户需要注册用户名) |
UJCMS_ | …oauth. | 微信 AppID(商业版标准版起;QQ、WEIBO 同理) |
UJCMS_ | …oauth. | 微信 AppSecret,建议通过 Secret 注入 |
UJCMS_ | …ai. | https:(AI 服务商接口地址;商业版标准版起) |
UJCMS_ | …ai. | deepseek-chat(与 _BASEURL 须同时给出) |
UJCMS_ | …ai. | API 密钥,建议通过 Secret 注入 |
UJCMS_ | …ai. | DeepSeek(可选,缺省取模型名) |
UJCMS_ | …ai. | {"enable_(可选,JSON 对象) |
UJCMS_ | …ai. | 百度翻译 APP ID(设为翻译服务商;商业版标准版起) |
UJCMS_ | …ai. | 百度翻译密钥,建议通过 Secret 注入(与 _APPID 须同时给出) |
如需配置更多站点,继续使用 UJCMS_ 等变量,依次增加站点序号。
三、敏感信息
不要在镜像或 Compose 配置中直接写入生产环境密码。系统支持 Docker Secret:挂载到 /run/secrets 的 secret 以文件名作为配置键载入,例如 secret 文件名 ujcms.,其内容即管理员密码(镜像内的 docker/ 已配置 spring.)。注意列表项(users[n]、 sites[n])整条只从一个配置源绑定:UJCMS_ 通过环境变量配置时, users[0]. 也必须通过环境变量配置(secret 文件里的 ujcms. 不会被合并进来);要用 secret 文件,就把该条目的全部字段都放进 secret 文件。
四、主题
本地主题目录
把主题包 ZIP 目录挂载进容器(如 -v .), 设 UJCMS_,启动时会自动导入主题包库,站点条目 用 theme: { source: library, ref: <主题名> } 引用,即可在离线环境中安装主题。
主题随镜像更新
挂载目录 /ujcms/static 里的主题(themes/**)属站点数据,换镜像时入口脚本只迁移控制台 cp/, 不覆盖主题,控制台里改过的模板得以保留——但也意味着新版本带来的模板改动不会自动到达已安装的站点。演示 / 测试站可设 UJCMS_:换镜像后的首次启动,入口脚本把镜像内置的主题目录(themes/、themes/error)与主题包 (UJCMS_ 下的 ZIP,按包内 themeName 匹配各站点已安装的同名实例)整目录覆盖到 static/themes 下, 模板随发版更新;不动数据库与 uploads/,也不更新主题包库里的存量包。正式站请勿开启。要立即重同步,删掉挂载目录里的 cp/.timestamp 再重启容器。
五、字体
镜像内置开源字体(思源黑体 / 宋体、Liberation、Carlito、Caladea 等,均可随镜像再分发)。文档里的 宋体、微软雅黑、黑体、楷体、仿宋与 Arial、Times New Roman、Calibri 等字体名由 fontconfig 自动替换,文库的 Office 转 PDF 与 DOC 导入不再缺字。镜像不内置 Windows / Office 自带的字体:它们的许可不允许随镜像再分发。如需与原文档完全一致的排版, 可把自己持有许可的字体目录挂载到容器的 /usr/ 下(如 -v .),fontconfig 会优先使用真实字体。
六、数据库驱动
发行包内置 MariaDB Connector/J(LGPL-2.1,同时连接 MySQL 与 MariaDB)、PostgreSQL、达梦、瀚高四种驱动, 镜像与 jar / war 一致,不需要另外下载任何驱动。MySQL 与 MariaDB 的 JDBC URL 一律写成 jdbc:(镜像由 UJCMS_DB_HOST 等变量拼成同样的形式): allowPublicKeyRetrieval= 让 MySQL 8 默认的 caching_sha2_password 认证能在未加密连接上向服务器索取 RSA 公钥, allowLocalInfile= 禁止服务器要求客户端上传本机文件,nullDatabaseMeansCurrent= 让不带库名的元数据查询只看当前库 (工作流引擎建表前这样检查表是否存在;同一服务器上有多个 UJCMS 库时少了它空库首次启动会失败);加密连接再加 sslMode=trust(只加密)或 sslMode= (校验证书)。驱动按 JVM 时区读写时间,模板也按 JVM 时区格式化,镜像已设 TZ=Asia/,裸机部署请保证系统时区或 -Duser.timezone 正确。发行包不含 MySQL Connector/J(GPL-2.0 加 Universal FOSS Exception,不能随商业版一起分发)。
需要发行包没有的驱动时(人大金仓、openGauss、海量数据库等,或坚持使用 MySQL Connector/J):Docker 把驱动 jar 挂载到容器的 /ujcms/ext/(镜像的启动命令 java -cp ujcms. 会读取它,自定义 command 时请保留这个写法);jar 包把驱动放到 ujcms-*.jar 同目录的 ext/ 下,以 java -cp ujcms-<版本>. 启动(java -jar 不读取 ext/);war 包把驱动放到 Tomcat 的 lib/ 目录。
七、升级
换用新版本的镜像后重新创建容器即可,数据在挂载的卷里;主题模板不随镜像更新,见“主题随镜像更新”。 跨版本升级(从 12.x、13.1.x 升级)的注意事项见升级的“跨版本升级的注意事项”一节。