跳至主要内容

部署后端基座

2026/10/26大约 4 分钟

部署后端基座（am-serve）

后端基座 am-serve 有两种部署方式，任选一种往下走即可：

  • 方式一 · 发行包一键部署（推荐） —— 基座程序固定，依赖与前端产物都已内置，下载、解压、启动三步即可，适合生产上线。
  • 方式二 · 源码部署 —— 拉取 git 源码，自行安装依赖、构建前端、开发调试，适合开发者与二次开发。

两种方式部署完都还「没装好」

本文只负责把服务跑起来（监听 :8787）。数据库、.env、管理员账号等初始化统一由安装向导完成，请勿手动改 .env 或导入 SQL。服务启动后请继续访问 → 运行安装向导。

一、环境要求（两种方式通用）

依赖版本用途
PHP>= 8.4运行时（Webman / Workerman 常驻内存）
MySQL>= 8.0主数据库，向导可自动建库
Redis>= 5.0缓存、会话、队列

PHP 必需扩展（安装向导的环境检测会逐项校验）：

扩展用途
pdo_mysqlMySQL 连接，ORM 底层依赖
redisRedis 连接，缓存/队列/会话依赖
opensslJWT 签名、密码哈希
zip备份打包、插件安装（ZipArchive）
gd验证码、缩略图裁剪
fileinfo文件 MIME 检测，上传安全校验

快速自检扩展是否齐全

php -m | grep -Ei 'pdo_mysql|redis|openssl|zip|gd|fileinfo'

缺哪个就在 php.ini 里去掉对应 ;extension=xxx 的行注释放开，重启 PHP 生效。

仅源码方式额外需要：Composer、Node.js >= 20.19.0、pnpm >= 8.8.0。发行包方式无需这些，因为依赖与前端产物已内置。

二、方式一：发行包一键部署（推荐）

发行包（形如 atrman_1.0.1_full.zip）由官方构建发布，已内置 vendor/ 后端依赖与编译好的管理前端 public/，基座程序固定。你不需要装 Composer、不需要 pnpm build，只要服务器有 PHP / MySQL / Redis，把包下载、解压、启动即可。

1. 准备环境

按上文「环境要求」装好 PHP（含扩展）、MySQL、Redis。数据库可以先不建——向导会用你填的库名自动 CREATE DATABASE。

2. 下载并解压

一键脚本（下载 → 解压 → 启动全自动，与首页终端展示的命令一致）：

curl -fsSL https://apps.atrman.com/app/am_store/install.sh | bash

占位命令

apps.atrman.com/app/am_store 为占位域名，官方安装脚本尚未发布；上线时请同步修改本页与首页终端（HomeArchitecture.vue）。

手动执行（效果与脚本完全相同）：从官方应用市场 / 交付渠道取得发行包，放到部署目录解压（包内是单顶层目录 atrman/）：

cd /var/www                       # 部署根位置，按你的环境自选
unzip atrman_1.0.1_full.zip       # 解压得到 /var/www/atrman/
cd atrman

关于「一键脚本」

发行包部署本质就是「下载 → 解压 → 启动」三步，没有任何依赖安装环节。一键脚本即替你串起这三步并自动 unzip 后 php start.php start -d；脚本不可用时，按下面手动命令执行效果完全相同。

3. 目录可写权限

runtime/（缓存/日志/安装锁）与 public/（上传/静态资源）需对运行用户可写：

chmod -R 755 runtime public
# 如以 www 用户运行：chown -R www:www runtime public

4. 启动

# Linux / macOS
php start.php start -d        # 守护模式（生产推荐）

# 前台调试（Ctrl+C 即停，日志直接打印到终端）
php start.php start

Windows 桌面环境（仅开发调试）可执行 php windows.php，自带文件监控自动重载。

服务默认监听 http://0.0.0.0:8787（worker 数为 cpu_count() * 4，并含 plugin_task 单进程调度插件定时任务）。看到监听成功后，打开浏览器继续 → 运行安装向导。

5. 常用运维命令

php start.php stop       # 停止
php start.php restart    # 重启（改了 .env / 配置后）
php start.php reload     # 平滑重载（改了常驻内存的注册代码）
php start.php status     # 运行状态

三、方式二：源码部署（开发 / 二开）

需要改动基座代码、参与开发或调试时，从 git 源码构建。相比发行包，多了「装依赖」和「构建前端」两步。

1. 获取源码

git clone <仓库地址> atrman
cd atrman

2. 安装后端依赖

cd am-serve
composer install

生产环境可加 --no-dev --optimize-autoloader 精简依赖。

3. 构建管理前端

管理前端 am-web 的构建产物会回写到 am-serve/public/（详见 安装管理前端）：

cd ../am-web
pnpm install
pnpm build              # 产物回写到 am-serve/public/

开发热调试时不必每次 build，用 pnpm dev 起 Vite（自动代理到后端 :8787）即可。

4. 启动后端

cd ../am-serve
php start.php start     # 前台调试
# Windows 开发：php windows.php

5. 运行安装向导

浏览器访问 http://127.0.0.1:8787/install.html，后续与发行包方式完全一致 → 运行安装向导。

改了 PHP 代码不生效？

Webman 常驻内存，修改 PHP 代码后需 php start.php reload（平滑）或 restart（重启）才生效；Windows 下 windows.php 自带文件监控会自动重载。

下一步

两种方式服务跑起来后，都进入同一初始化流程：→ 运行安装向导

最近更新: