SoeayCMS 的部署过程极其简单：下载、解压、配置 Web 根目录，即可访问站点。本文档提供从安装到第一个模板的完整流程。

一、环境要求

二、目录结构

安装包解压后的核心目录如下：

SoeayCMS-work/
├── soeay/              # 核心框架
│   ├── apps/           # 应用模块
│   │   ├── admin/      # 后台管理
│   │   └── home/       # 前台模块
│   ├── core/           # 核心类
│   │   ├── template/   # 模板引擎与标签解析器
│   │   └── basic/      # 基础工具类
│   └── config/         # 核心配置
├── public/             # Web 根目录
│   ├── index.php       # 前台入口
│   ├── soeay_admin/    # 后台管理前端（静态资源）
│   ├── template/       # 前台模板目录
│   └── upload/         # 用户上传目录
├── database/           # 数据库目录
├── runtime/            # 运行时目录
└── config/             # 站点配置

三、安装步骤

1. 将安装包上传至服务器 Web 根目录，确保 public/ 目录是站点根。
2. 设置 runtime/、public/upload/、config/、database/ 为可写（Linux chmod 755 或 777）。
3. 浏览器访问站点根域名，系统自动跳转到安装向导，或手动访问 /install/。
4. 按向导提示填写数据库信息、后台管理员账号密码（默认账密：admin/123456），完成安装。
5. 安装完成后，默认后台地址为 /soeay_admin/，建议立即修改管理员密码。

四、伪静态配置

SoeayCMS 所有 URL 都是伪静态路径（如 /news/123.html、/store.html），需要在 Web 服务器配置 rewrite 规则。详见"伪静态配置"章节。

五、第一个模板

在 public/template/default/html/ 目录下创建 hello.html，内容如下：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>{soeay:site.title}</title>
    <meta name="keywords" content="{soeay:site.keywords}">
    <meta name="description" content="{soeay:site.description}">
    <link rel="stylesheet" href="{soeay:sitetplpath}/css/style.css">
</head>
<body>
    <header>
        {soeay:include file="comm/nav.html"}
    </header>

    <main class="container">
        <h2>最新动态</h2>
        <ul>
        {soeay:list scode=2 num=10}
            <li><a href="[soeay:link]">[soeay:title]</a></li>
        {/soeay:list}
        </ul>
    </main>

    <footer>
        {soeay:include file="comm/foot.html"}
    </footer>
</body>
</html>

保存后在后台"栏目管理"新建一个栏目 scode=99，模板选择 hello，前台访问 /hello.html 即可看到模板输出。

六、常用开发路径