从零跑起来

五分钟装上 aucms,认识后台每个菜单是干什么的,知道遇到问题该翻哪一章。

约 3 分钟 入门 代码块右上角可一键复制
本页目录(3 分钟读完)

这一章只做三件事。

装起来、进后台、发第一篇。

装不上、报 500、白屏 → 看 排错手册。

怎么在本机跑起来#

只用来试玩,别对外用。

  1. 把项目放到任意目录
  2. 在项目根目录执行命令
  3. 浏览器打开 http://127.0.0.1:8080/
Shell
php -S 127.0.0.1:8080 server.php

打开后会进安装向导。

打不开? → 看 排错手册

怎么装起来#

打开域名,按向导走五步。

  1. 环境检测:有红项就先停
  2. 目录权限:runtime/、data/ 要可写
  3. 数据库:选 MySQL 或 SQLite
  4. 管理员账号:填账号和强密码
  5. 完成:点「完成」

装完做三步收尾,别跳过。

Shell
# 1) 移走安装目录
mv install /root/aucms-install-backup

# 2) 确认密钥在
ls -l data/secret.key

# 3) 环境自检
php aucms env:check

装不上? → 看 排错手册

怎么进后台#

  1. 浏览器打开 /admin
  2. 填刚才的账号
  3. 填密码和验证码
  4. 点「登录」

登录后左边是菜单。

进不去? → 看 排错手册

怎么认菜单#

按建站顺序看这张表。

菜单干什么
控制台看今日数据
文章管理发文章、改文章
内容模型定义文章有哪些字段
栏目管理建导航目录
系统设置改站点配置
缓存与维护清缓存、重建

怎么发第一篇文章#

分四步走,先建模,再建栏,后发文。

第 1 步:确认有文章模型#

  1. 点「内容」→「内容模型」
  2. 看有没有「文章」
  3. 没有就点「新增」
  4. 标识填 article
  5. 类型选「栏目型」
  6. 点「保存」

第 2 步:建一个栏目#

  1. 点「内容」→「栏目管理」
  2. 点「新增」
  3. 栏目名称填「新闻中心」
  4. URL 别名填 news
  5. 所属模型选「文章」
  6. 点「保存」

第 3 步:发内容#

  1. 点「内容」→「文章管理」
  2. 点「发布」
  3. 填标题、正文
  4. 栏目选「新闻中心」
  5. 状态选「发布」
  6. 点「保存」

第 4 步:看效果#

  1. 打开 /list/news
  2. 点刚发的文章标题

看不到? → 看 排错手册

怎么用命令行自检#

三条常用命令,复制就能跑。

Shell
php aucms env:check
php aucms cache:rebuild
php aucms route:list
命令什么时候用
env:check装完、出问题时
cache:rebuild改完模板后
route:list404 时

接下来看哪一章#

按目标挑一章,不用全看。

我想去看
改站点名、SEO、伪静态建站第一小时
加产品、案例等内容内容模型与字段
把栏目和导航理清栏目与导航
发布和审核内容发布内容
部署到服务器部署上线
换服务器 / 换域名 / 改数据库密码搬家与换域名
改了不生效 / 清缓存 / 改缓存名缓存怎么清、缓存名怎么改
让 AI 帮我写插件、改模板AI 开发助手
报错、白屏排错手册
没找到答案? 在后台「缓存与维护 → 系统体检」里看环境是否正常;仍无解就打开 server_debug.php 复现一次,页面会直接告诉你异常文件与行号。