存储点
校对日期:2026-11-16。存储类型为“本地服务器”时适用于社区版及全部商业版;“FTP服务器”“对象存储”需要商业版标准版及以上。
程序运行中会产生四类文件:上传的附件、生成的静态页、主题模板、主题包。每一类由一个存储点决定存到哪里、用什么地址访问。 默认都存放在程序目录下,单机部署一般不用改;本文说明各存储点的含义,以及怎样把附件挪到程序目录之外。 多个节点共用存储的做法见集群部署的“文件存储:共享目录与对象存储”一节。
一、四个存储点
进入 配置 → 全局设置 → 存储设置,用上方的按钮在四个存储点之间切换。存储点是全局设置,所有站点共用。

| 存储点 | 默认的存储路径和访问路径 | 存放什么 |
|---|---|---|
| 附件存储点 | /uploads | 上传的图片、视频、附件,按站点分目录,如 /uploads/(1 是站点 ID) |
| 静态页存储点 | 留空,即程序目录本身 | 开启静态化后生成的 HTML 页面 |
| 模板存储点 | /themes | 各站点的主题:模板、样式、脚本和图片 |
| 主题包存储点 | /theme-packages | ZIP 格式的主题包 |
“程序目录”指存放静态文件的那个目录:Jar 部署是 <部署目录>/static,Tomcat 部署是 webapps/ROOT。
模板存储点和主题包存储点虽然在程序目录下,但不是里面的文件都能用浏览器打开:主题目录只放行 assets/、thumbnails/ 和图片,模板源文件与主题安装包一律返回 404,见主题安全与部署约束的“主题文件的对外访问范围”一节。
每个存储点有三项设置:
- 存储类型:本地服务器、FTP服务器、对象存储。
- 存储路径:文件保存到哪里。
- 访问路径:生成文件地址时用的前缀。它只用来拼地址,这个地址能不能打开,要靠存储路径与访问路径真的对应上。
二、本地服务器
存储路径 有两种写法:
- 以
/开头:程序目录下的目录。默认的/uploads就是<程序目录>/uploads。 - 以
file:开头:服务器上的任意目录,如file:、/ data/ ujcms/ uploads file:。 为了防止误填把服务器上的其它目录暴露出去,这样的路径要先在配置文件里登记(见下一节),否则保存时会提示 “以 file: 开头的路径需要在配置文件(application.yaml)的 ujcms.storageFilePrefix 中列入白名单”。d: / ujcms/ uploads
访问路径 可以是站内路径(/uploads),也可以是带域名的完整地址(https:)。 存储路径在程序目录下时,访问路径与它保持一致即可,程序自己就能把文件发送出去;存储路径在程序目录之外时, 要另行安排由谁来提供这些文件。
存储路径和访问路径里都不能出现 ..。
三、把附件存到程序目录之外
附件默认在程序目录里,升级和迁移时要小心保留(见升级)。把它放到独立的目录, 换程序时就不用再管它。以 Linux、存到 /data/、前面有 Nginx 为例:
登记允许的目录。 在
application.(Jar 为yaml config/,Tomcat 为application. yaml WEB-INF/)中设置, 然后重启程序:classes/ application. yaml yaml# 允许存储点使用的 file: 目录及其子目录,多个用英文逗号分隔 ujcms.storageFilePrefix: file:/data/ujcms搬移已有文件。 把
<程序目录>/uploads下的内容复制到/data/,并确认运行程序的用户对该目录有读写权限。 修改存储点不会自动搬移文件。ujcms/ uploads 修改存储点。 在 存储设置 → 附件存储点 里把 存储路径 改为
file:,访问路径 保持/ data/ ujcms/ uploads /uploads,保存。 访问路径不变,已发布内容里的图片地址就不用改。让
/uploads这个地址能访问到新目录。 在 Nginx 的站点配置里加上:nginxlocation /uploads/ { alias /data/ujcms/uploads/; }没有使用 Nginx 时,可以让程序自己提供这个目录(
spring.), 写法见集群部署的“方案一:共享挂载”一节。web. resources. static-locations
改完之后上传一张图片验证:文件出现在新目录里,并且在文章里能正常显示。
其它存储点的改法相同,另有两点:
- 模板存储点 改了存储路径,还要把配置文件里的
spring.指向同一个目录 (末尾保留freemarker. template-loader-path /),否则页面渲染时找不到模板。 - 静态页存储点 改到程序目录之外后,要由 Web 服务器从这个目录发送静态页, 做法参考 Nginx 反向代理的“由 Nginx 直接发送静态文件”一节。
四、FTP 服务器(标准版)
把文件通过 FTP 上传到另一台服务器。选择 FTP服务器 后填写:
| 字段 | 说明 |
|---|---|
| IP地址 | FTP 服务器的地址 |
| 端口号 | 默认 21,可以留空;TLS 隐式加密一般是 990 |
| 用户名、密码 | 密码保存后不再显示,再次打开时为空,留空表示不修改;改了 IP 地址要重新填写密码 |
| 编码 | 默认 UTF-8 |
| 被动模式 | 一般保持开启 |
| 加密方式 | 不加密、TLS隐式加密、TLS显式加密 |
| 存储路径 | FTP 服务器上的目录,如 /uploads |
| 访问路径 | 浏览器访问这些文件的地址前缀。FTP 本身不提供网页访问,那台服务器上要有 Web 服务指向同一个目录,如 https: |
五、对象存储(标准版)
通过兼容 S3 的接口把文件保存到对象存储(MinIO、阿里云 OSS、腾讯云 COS、七牛云 Kodo、AWS S3)。 各字段的填法、存储桶的访问权限,以及模板、静态页放到对象存储时的额外配置,见集群部署的“方案二:对象存储”一节; 单机部署的填法相同。
六、不归存储点管的目录
- 全文索引:由配置文件的
ujcms.决定,默认是程序目录下的lucene-path /WEB-INF/lucene,同样可以写成file:开头的任意目录。 索引可以随时在 系统 → 生成管理 里重建。 - 备份文件:保存在程序目录下的
/WEB-INF/backup,见备份管理。
七、常见问题
- 保存时提示要配置
ujcms.白名单:存储路径以storageFilePrefix file:开头,但不在登记的目录之内。 登记的值本身也要以file:开头(写file:,不是/ data/ ujcms /data/ujcms),修改后要重启程序。 - 上传成功,但图片显示不出来(404):访问路径没有对应到存储路径。按“把附件存到程序目录之外”一节第 4 步检查由谁提供这个地址; 可以直接在服务器上确认文件是否已经写到存储路径下。
- 修改存储点之后,以前的图片打不开:已有的文件不会自动搬到新位置,按“把附件存到程序目录之外”一节第 2 步搬移。 访问路径如果也改了,已发布内容里保存的仍是原来的地址,需要让原地址继续可用。
- 选了“FTP服务器”或“对象存储”不能保存,或者看不到这两个选项:它们是标准版的功能。社区版能看到选项但不能保存,基础版不显示这两个选项。