核对来源与签名
只使用官方渠道获取的安装包；升级包自带 RSA 签名，验签不通过一律不要应用。
安装前
环境要求
先把这四项对一遍，能省掉绝大多数安装期的问题。
环境清单
PHP >= 8.1（建议开启 openssl / mbstring） MySQL >= 8.0，建议一主一备 Web Nginx + PHP-FPM，站点根目录指向 public/ 扩展 json / mbstring / openssl 必备；zip 缺失时出包有兜底 权限 public/ 可读；apcore/storage/ 与缓存目录可写
后台前端为单文件 + jQuery，不需要 Node 与打包工具；改完模板或页面刷新即可看到效果。
安装步骤
- 上传程序，把站点根目录 / 文档根指向
public/，其他目录不对外暴露。 - 新建数据库与账号，填写
.env或在安装向导中录入连接信息。 - 访问安装向导，按五步完成环境检测、数据库初始化、管理员创建与站点设置。
- 后台「系统设置」填写站点名称、联系方式与备案号，前台主题即时读取。
- 删除或保护安装锁文件，确认
apcore/storage/不在 Web 根内。
校验与排错
升级前可在后台做完整性清单比对：核对官方文件哈希，识别现场被改动的文件，避免误覆盖二开内容。若出现白屏，先看 cache/logs/ 下当日日志，再检查目录权限与扩展是否齐全。
后续升级
日常升级走后台「在线升级」：检查版本 → 下载签名包 → 校验 → 应用 → 可回滚。也可以导出离线全量包，供无外网的客户导入。
安全提示
下载之后，记得做这三件事
目录不要放错
Web 根必须指向 public/，apcore/、template/、apcore/storage/ 都不应能通过 URL 直接访问。
先备份再升级
升级前备份数据库与现场二开目录；虽然出包白名单不会覆盖现场文件，备份仍是兜底。
常见问题
下载与安装
安装需要联网吗？
基础安装不需要联网，解压并配好数据库即可。在线升级与授权查询需要能访问官网升级网关；无外网环境可走离线升级包与离线授权文件。
没装 zip 扩展能出升级包吗？
可以。出包组件自带一份零依赖的 ZIP 实现，zip 扩展缺失时自动使用，不影响打包与解包。
升级会覆盖我改过的模板和现场配置吗？
不会。出包白名单只含核心与官方应用目录，模板、配置、上传、客户自建应用一律不下发；连删除动作也只在白名单内生效。
多个站点要装几套？
每套部署独立安装；授权按域名绑定。多站点 / 集团站建议走企业定制，统一升级与授权管理更省事。