Jar 部署
校对日期:2026-11-16。适用于社区版及全部商业版。
Jar 安装包内置 Tomcat,解压后用一条 java -jar 命令即可启动,是除 Docker 之外最简单的部署方式。 需要部署到已有的 Tomcat 时见 Tomcat 部署,部署到东方通时见东方通 TongWeb 部署;用 Docker 时见 Docker 部署。
一、准备
- JDK 17 或 21,见 JDK 选择与安装。
- MySQL 8.0(5.7.22 及以上、8.0.20 及以上;小版本过低可能导致程序无法启动)。也支持 MariaDB 和 PostgreSQL; 达梦、瀚高等国产数据库需要商业版基础版及以上。驱动均已内置,不需要另外下载。
- 一个空数据库。库名任意(如
ujcms),MySQL 字符集选utf8mb4(不要用utf8,部分特殊字符会乱码)。 不需要执行任何建表脚本:程序首次启动时自动建表并写入初始数据。数据库账号须有建表、改表结构和读写数据的权限。 - 安装包。在官网下载页 https://www.ujcms.com/downloads/ 下载 jar 安装包,也可以从源码构建。
二、部署与启动
解压安装包到部署目录(如 Linux 的
/opt/ujcms、Windows 的D:\ujcms)。路径中不要有中文或空格。解压后的结构:文件 / 目录 内容 ujcms-x.x.x.jar程序本体 config/application. yaml 配置文件。程序启动时读取它,覆盖 jar 包内的同名配置,改配置不需要动 jar 包 static/cp/后台管理界面 static/themes/前台模板 static/uploads/上传的文件 static/WEB-INF/运行时生成的全文索引( lucene/)、备份文件(backup/)等upgrade/部分版本升级时需要手动执行的 SQL 脚本,见升级 填写数据库连接。打开
config/,修改三项:application. yaml yamlspring.datasource.url: jdbc:mariadb://127.0.0.1:3306/ujcms?allowPublicKeyRetrieval=true&allowLocalInfile=false&nullDatabaseMeansCurrent=true spring.datasource.username: 数据库用户名 spring.datasource.password: 数据库密码MySQL 与 MariaDB 都使用
jdbc:mariadb://开头的地址,把其中的127.0.0.1、3306、ujcms换成数据库的地址、端口和库名。 PostgreSQL 及国产数据库的写法见该文件中的注释。启动。在部署目录(jar 文件所在的目录)中执行:
bashjava -jar ujcms-x.x.x.jar必须在部署目录中执行:程序按当前工作目录查找
config/和static/,在别的目录执行java -jar /会找不到配置和模板。opt/ ujcms/ ujcms-x. x. x. jar 等待启动完成。首次启动要建表并写入初始数据,需要一些时间。日志中出现
Started Application in xxx seconds即启动完成。完成安装。浏览器打开
http:,进入安装向导,设置站点和管理员账号。向导第一步需要的安装令牌 在启动日志里,也写在/ / 服务器地址: 8080/ cp/ static/中。系统没有默认的管理员密码。各步骤的说明见安装向导与无人值守安装。WEB-INF/ install-token. txt
安装完成后,前台地址为 http:,后台地址为 http:。
三、启动参数
| 需求 | 写法 |
|---|---|
| 修改端口 | 命令末尾加 --server.,或在 config/ 中设置 server.port |
| 指定时区 | -jar 之前加 -Duser.。数据库驱动和模板都按 JVM 时区读写、显示时间,服务器系统时区不正确时需要设置 |
| 限制内存 | -jar 之前加 -Xms / -Xmx,如 -Xmx2g |
四、在 Linux 上长期运行
临时在后台运行,日志写入 ujcms.log:
nohup java -jar ujcms-x.x.x.jar > ujcms.log 2>&1 &停止程序用 kill <进程号>,进程号可用 ps -ef | grep ujcms 查看。
生产环境建议注册为 systemd 服务,开机自启、异常退出后自动重启。新建 /etc/, 其中 WorkingDirectory 必须指向部署目录:
[Unit]
Description=UJCMS
After=network.target
[Service]
WorkingDirectory=/opt/ujcms
ExecStart=/usr/bin/java -jar /opt/ujcms/ujcms-x.x.x.jar
SuccessExitStatus=143
Restart=on-failure
[Install]
WantedBy=multi-user.targetsystemctl daemon-reload && systemctl enable --now ujcms # 注册并启动
journalctl -u ujcms -f # 查看日志五、常见问题
访问前台提示找不到模板,或后台打不开。 没有在部署目录中启动程序,见上文第 3 步;用 systemd 时检查
WorkingDirectory。启动时报
Could not acquire change log lock或一直显示Waiting for changelog lock...。 上一次启动在建表或升级表结构时被强行中断。 清空数据库中databasechangeloglock和flw_两张表的数据(注意不是ev_ databasechangeloglock databasechangelog)后重新启动; 全新安装时也可以直接重建数据库。启动时报
Specified key was too long; max key length is 767 bytes。 把 MySQL 参数innodb_设为large_ prefix ON。 MySQL 5.7.7 起该参数默认已开启,但部分面板或云数据库修改了默认配置。启动时报
Connection to … refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.程序连不上数据库。先核对spring.里的地址和端口;地址无误时,通常是数据库没有允许从程序所在的服务器连接。 PostgreSQL 以及瀚高等同类数据库要在数据库一侧放开监听地址(datasource. url postgresql.conf的listen_)和客户端地址(addresses pg_hba.conf), 改后重启数据库,具体做法以数据库厂商的文档为准。需要安装包里没有的数据库驱动(人大金仓、openGauss 等)。把驱动 jar 放到部署目录的
ext/下,改用下面的命令启动 (java -jar不读取ext/):bashjava -cp ujcms-x.x.x.jar -Dloader.path=ext org.springframework.boot.loader.launch.PropertiesLauncher