认识安企CMS-系统文件结构

了解安企CMS安装后的完整目录结构，掌握主程序、配置文件、模板目录、附件目录、运行时数据等每个关键目录和文件的具体作用，方便后续日常维护和二次开发。

安企CMS 安装后的完整目录结构概览，带你了解每个目录和文件的用途。

一、顶层目录结构

anqicms/                          # 网站根目录
├── anqicms                       # 主程序可执行文件（Linux/Mac）
├── anqicms.exe                   # 主程序可执行文件（Windows）
├── config.json                   # 配置文件（端口、数据库、站点名称等）
├── config.sample.json            # 配置示例文件（首次启动自动复制为 config.json）
├── template/                     # 🎯 模板目录（重点，见下文详解）
├── public/                       # 🎯 Web 根目录（Nginx 运行目录，见下文详解）
├── data/                         # 数据目录
│   ├── backup/                   # 数据库备份文件
│   ├── cert/                     # 支付证书文件
│   └── logs/                     # 运行日志
├── cache/                        # 缓存目录（文件缓存、模板缓存）
├── locales/                      # 国际化语言包
│   ├── zh-CN/                    # 简体中文
│   ├── en-US/                    # 英文
│   ├── ja-JP/                    # 日文
│   ├── ru-RU/                    # 俄文
│   ├── pt-BR/                    # 葡萄牙文
│   ├── id-ID/                    # 印尼文
│   └── bn-BD/                    # 孟加拉文
├── dictionary.txt                # 中文分词词典（全文搜索用）
├── CHANGELOG.md                  # 版本更新日志
├── README.md                     # 项目说明
└── License                       # AGPL-3.0 开源协议

注意：仅从编译包（release 模式）解压后看到的是运行必需目录。从 GitHub 克隆源码目录包含更多开发相关文件（controller/、model/、go.mod 等），生产环境部署时可删除。

二、模板目录（template/）详解

template/ 是安企CMS 的模板根目录，每套模板独立一个子目录。系统通过 config.json 识别和加载模板。

2.1 模板配置文件 config.json

每套模板目录下都包含 config.json，默认会自动生成，可手动修改。内容格式如下：

{
    "name": "默认模板",
    "package": "default",
    "version": "1.0",
    "description": "系统默认模板",
    "author": "kandaoni.com",
    "homepage": "https://www.kandaoni.com",
    "created": "2022-05-10 22:29:00",
    "template_type": 0,
    "status": 0
}

2.2 模板文件组织模式

安企CMS 默认支持文件夹模式组织方式。

文件夹模式

template/mytemplate/
├── config.json                          # 模板配置文件（必须）
├── base.html                            # 公共基础模板（页头/页脚等公共布局）
├── partial/                             # 代码片段目录
│   ├── header.html                      # 页头（导航、Logo）
│   ├── footer.html                      # 页脚（版权、备案号）
│   ├── sidebar.html                     # 侧边栏
│   └── pagination.html                  # 分页组件
│
├── index/
│   └── index.html                       # 首页
│
├── archive/                             # 文章模型（默认模型 table=archive）
│   ├── index.html                       # 文章模型首页
│   ├── list.html                        # 文章列表页
│   ├── list-{分类ID}.html               # 特定分类的列表页（如 list-5.html）
│   ├── detail.html                      # 文章详情页
│   └── detail-{文档ID}.html             # 特定文档的详情页（如 detail-1.html）
│
├── product/                             # 产品模型（table=product）
│   ├── index.html                       # 产品模型首页
│   ├── list.html                        # 产品列表页
│   ├── list-{分类ID}.html               # 特定产品分类列表页
│   ├── detail.html                      # 产品详情页
│   └── detail-{文档ID}.html             # 特定产品详情页
│
├── page/                                # 单页面
│   ├── detail.html                      # 单页面详情页
│   └── {Url别名}.html            # 特定单页面（如 detail-about.html）
│
├── tag/
│   ├── index.html                       # 标签首页
│   └── list.html                        # 标签文档列表页
│
├── comment/
│   └── list.html                        # 评论列表页
│
├── guestbook/
│   └── index.html                       # 在线留言页
│
├── search/
│   └── index.html                       # 搜索页
│
├── errors/
│   ├── 404.html                         # 404 错误页
│   ├── 500.html                         # 500 错误页
│   └── close.html                       # 站点关闭提示页
│
└── mobile/                              # 手机端模板目录（template_type=2 时使用）
    ├── index/
    │   └── index.html
    ├── archive/
    │   ├── list.html
    │   └── detail.html
    └── ...                              # 结构同 PC 端

2.3 模板文件与页面匹配规则

| 页面类型 | 文件夹模式路径 |

{模型table} 是内容模型中定义的 table_name，默认文章模型为 archive，产品模型为 product。

2.4 模板命名规范

三、Web 根目录（public/）详解

public/ 是 Nginx 反向代理时必须指向的 Web 根目录，包含了所有可直接访问的静态资源。

anqicms/public/
├── static/                              # 静态资源目录
│   ├── default/                             # 模板对应文件夹
│   │   ├── css/                             # 模板样式文件
│   │   │   ├── style.css
│   │   │   └── ...
│   │   ├── js/                              # JavaScript 文件
│   │   │   ├── main.js
│   │   │   └── ...
│   │   └── images/                          # 图片资源
│   │       ├── logo.png
│   │       └── ...
├── uploads/                             # 上传资源目录（用户上传的图片/文件）
│   ├── images/                          # 按年/月自动归档
│   │   ├── 2026/
│   │   │   ├── 01/
│   │   │   ├── 02/
│   │   │   └── ...
│   │   └── ...
├── robots.txt                           # 爬虫规则（后台可配置）
├── sitemap.xml                          # Sitemap 索引文件（自动生成）
└── LLMs.txt                             # AI 索引文件（后台可配置）

四、各目录/文件在生产环境的必要性

五、安全提醒：public/ 的根目录配置

务必确保 Nginx 配置中的 root 指向 public/ 目录，而不是 anqicms/ 根目录：

# ❌ 错误 —— 用户可直接访问 config.json、template/ 等敏感文件
root /data/wwwroot/anqicms;

# ✅ 正确 —— 外部只能访问 public/ 下的资源
root /data/wwwroot/anqicms/public;