快速上手

这篇文档只讲一件事：把 X1 从下载包变成能访问的网站，需要走哪几步。每一步都尽量短，安装细节不在这里展开，需要时点链接看专门文档。

整体流程

1. 下载发布包并校验。
2. 上传到服务器，配好站点根和目录权限。
3. 浏览器打开站点，创建第一个管理员。
4. 填好网站信息。
5. 发布第一页。

X1 是免费、源码开放的站点程序，当前版本 X1.0.0-beta.13。它没有分步安装向导，首次访问会自动建库，所以流程比传统 CMS 短。

第一步：下载与校验

从官方渠道拿到发布包后，先确认文件完整再上传。发布包里的 就是程序本体，站点根是 public/。

• 核对发布包提供的校验值，确认下载没有损坏。
• 解压后检查目录结构，public/、app/、data/ 都在。
• 发布包已经带 vendor/ 时，可以跳过安装依赖。

环境要求、PHP 扩展、nginx 配置、cron 这些内容，见环境要求与安装部署。

第二步：上传与目录权限

把 放到服务器上，站点根只指向 public/。app/ 和 data/ 必须放在站点根之外，不能被浏览器直接访问。

• data/ 要由运行网站的用户可写，数据库、app.key、缓存和上传文件都放在这里。
• 首次访问时程序会自动创建 data/app.key，并设为 0600。这个文件不要删除、不要替换。
• PHP 上传限制和 nginx 的 client_max_body_size 要一致或更大，否则大图会在到达程序前被拒绝。

具体命令和 nginx 示例见环境要求与安装部署。

第三步：首次访问，创建管理员

浏览器打开站点地址即可。数据库不存在时，程序会自动建库、建表、写入默认设置并生成 app.key，不需要手工导入 SQL。

管理员还没创建时，访问任何页面都会跳到 /admin/setup。在这个一次性设置页填写：

创建成功后，当前浏览器自动登录并进入后台首页 /admin，/admin/setup 永久返回 404，不能再用来创建第二个管理员。

站点名称不在这个页面填写，创建管理员后到「设置 → 站点基本 → 基本信息」修改。完整说明见首次访问与管理员账号。

第四步：填好网站信息

登录后台，左侧菜单点「设置」，进入「站点基本 → 基本信息」，把站点名称、联系方式等改成自己企业的信息。默认设置里的站点名称是「KingCMS」，这一步要改掉。

• 设置字段旁的「?」图标是帮助入口，鼠标悬停可以看到字段说明。
• 后台界面使用中文，设置分栏和菜单名称均为中文。
• 正式启用前应配好 HTTPS，微信、支付宝回调和 Secure cookie 都依赖 HTTPS。

各项设置的用途见参数设置。

第五步：发布第一页

内容按「系统设置 → 栏目管理」建栏目、再在「内容 → 文章」写文章来组织。先建栏目，再在栏目下写文章，页面就能在前台访问。

1. 左侧菜单点「系统设置 → 栏目管理」，新建一个栏目，例如「关于我们」。
2. 左侧菜单点「文章」，在该栏目下新建一篇，填标题和正文。
3. 保存后到前台打开，确认显示正常。

栏目和文章的字段说明见栏目与文章。

上线前顺手确认

• 后台右上角可以「修改密码」，新密码至少 8 个字符。
• 忘记管理员密码时，用 php bin/kingcms admin:reset-password 重置，不会清空栏目、文章、商品或设置。
• 配好 cron，让已启用模块的每分钟钩子和到期后台任务正常执行，见环境要求与安装部署。
• 需要备份时见备份，升级时见升级。

到这里，网站已经能访问、能登录后台、能发布内容。后面按业务需要再启用模块、调整主题和设置即可。