快速开始
校对日期:2026-11-16。适用于社区版及全部商业版。
本页说明怎样用最少的步骤得到一个能访问、带演示数据的 UJCMS 站点。这里只列出主干步骤,每种部署方式的完整说明、 参数和常见问题在各自的安装手册里。
一、选择部署方式
| 方式 | 需要事先准备 | 适合 | 完整说明 |
|---|---|---|---|
| Jar 安装包 | JDK、MySQL | 多数情况。安装包内置 Tomcat,一条命令启动 | Jar 部署 |
| War 安装包 | JDK、MySQL、Tomcat 10.1 及以上 | 要部署到已有的 Tomcat 或其它应用服务器 | Tomcat 部署 |
| Docker | Docker,以及构建源码所需的 JDK、Node.js | 熟悉 Docker;MySQL 也由容器提供 | Docker 部署 |
| 源码启动 | JDK、MySQL、Node.js、pnpm、Java 开发工具 | 二次开发 | 源码根目录的 README.md |
JDK 需要 17 或 21,MySQL 需要 8.0(5.7.22 及以上、8.0.20 及以上),见 JDK 选择与安装。 安装包在官网下载页 https://www.ujcms.com/downloads/ 下载。
二、用 Jar 安装包安装
建一个空数据库。库名任意(如
ujcms),字符集选utf8mb4。不需要执行建表脚本,程序首次启动时自动建表。解压安装包到一个路径中没有中文和空格的目录。
填写数据库连接。打开
config/,修改application. yaml spring.、datasource. url spring.、datasource. username spring.三项。datasource. password 启动。在解压出来的目录里执行:
bashjava -jar ujcms-x.x.x.jar首次启动要建表并写入初始数据,需要等一会儿。日志中出现
Started Application in xxx seconds即启动完成。走完安装向导。浏览器打开
http:,自动进入安装向导,共四步:/ / localhost: 8080/ cp/ 步骤 填什么 安装令牌 一串 32 位的字符,在启动日志里,也写在 static/文件中WEB-INF/ install-token. txt 站点设置 站点名称、协议、域名和端口。已按当前访问地址填好,本机试用不用改 管理员 自己设定管理员的用户名和密码,之后用它登录后台 主题与数据 主题来源选 内置默认主题(推荐),演示数据选 导入演示数据(推荐) 完成后点击 进入登录,用刚才设定的管理员账号登录。
安装完成后:
- 网站前台:
http:/ / localhost: 8080/ - 后台:
http:/ / localhost: 8080/ cp/
三、其它部署方式
War 安装包:把安装包里的 ROOT 文件夹拷贝到 tomcat/webapps/ 下,在 webapps/ 中填写数据库连接,启动 Tomcat。之后同样打开 /cp/ 走安装向导,安装令牌在 Tomcat 的日志和 webapps/ 中。
Docker:源码根目录的 compose.yaml 会启动 UJCMS 和 MySQL 两个容器,并自动完成安装、导入演示数据,不经过安装向导。 镜像用本地的构建产物制作,所以要先按该文件开头注释里的命令完成构建,再执行:
docker compose up -d --build管理员账号由 UJCMS_、UJCMS_ 两个环境变量决定。compose.yaml 里给了默认值, 启动之前请改成自己的密码(可以写在同目录的 .env 文件里)。
源码启动:按 README.md 依次配置数据库连接、构建默认主题的静态资源、编译后台界面,然后在源码根目录执行 ./mvnw clean spring-boot:。Node.js 和 pnpm 的安装见 Node.js 与 pnpm 安装。 开发环境不想每次走安装向导时,可以改用无人值守安装,见安装向导与无人值守安装的“无人值守清单”一节。
四、接下来
- 不清楚栏目、文章、区块、页面各是什么,先看基本概念。
- 建栏目、发文章:栏目管理、文章管理。
- 改网站的外观:主题开发。
- 正式上线前在 UJCMS 前面加一层 Nginx:Nginx 反向代理。
五、常见问题
- 后台的默认用户名和密码是什么? 没有默认密码。管理员账号是在安装向导的 管理员 一步里自己设定的; 用 Docker 或无人值守安装时,是配置里写的那一个。忘记密码见找回管理员密码。
- 安装令牌在哪里? 在启动日志里,前后有醒目的分隔线;也写在
WEB-INF/文件中,向导第一步会显示这个文件的完整路径。 程序每次重启都会重新生成令牌,以最后一次为准。install-token. txt - 安装时没有导入演示数据,能补上吗? 能。后台 设计 → 主题 里可以随时导入或移除演示数据,也可以安装、切换主题。
- 打开前台没有样式。 通常是程序没有部署在根路径下(地址类似
http:), 见 Tomcat 部署的“部署路径”一节。/ / localhost: 8080/ ujcms/ - 打开首页是 404“页面找不到”。 先看是谁的错误页面。如果是 Tomcat 自带的错误页面,说明程序没有部署在
webapps/ROOT下或者启动失败, 查看 Tomcat 的日志。如果是 UJCMS 的错误页面(大号的 404 和“页面找不到”),说明程序已经启动,常见原因是找不到站点主题的首页模板themes/:检查<站点ID>/ <主题>/ templates/ index. html themes目录是否完整;Jar 部署时确认是在部署目录中启动的, 见 Jar 部署的常见问题;改过模板存储点的见存储点。