首页 / 开发手册 / 装在哪、需要什么

装在哪、需要什么

服务器需要什么、三分钟装好一套站点、安装后该做的第一件事。

运行环境

这是一套 PHP 程序,必须跑在已经装好 PHP 的服务器上。能装它的地方:

  • 云服务器 / VPS(自己装 PHP 与 Nginx 或 Apache)
  • PHP 虚拟主机 / PHP 空间(主机商提供 PHP 的那种)
  • 面板建站环境(宝塔、cPanel、Plesk 之类,建一个 PHP 站点即可)

下面这些地方装不了,选主机时先看清楚:

  • 纯静态托管:GitHub Pages、Netlify / Vercel 的静态站、对象存储(OSS / COS)的静态网站功能 —— 它们只发静态文件,不执行 PHP
  • 只有 HTML 的免费空间:同理,没有 PHP 就没有这套程序

还有一条同样硬的要求:要能把域名的「网站根目录」指到 wwwroot/ 这个子目录。 主流主机都能设(面板里叫「网站根目录」「运行目录」「Document Root」)。为什么要这样,见「目录结构」那一篇。

服务器要求

  • PHP 7.4 及以上(程序按 7.4 语法编写,同时兼容 8.x)
  • 扩展:pdo_sqlite、mbstring、json、gd(图片处理)、fileinfo
  • 数据库:默认 SQLite,无需单独安装;也支持 MySQL / MariaDB
  • 磁盘:程序本体约 6 MB,其余取决于你上传的图片与附件

没有 pdo_sqlite 时程序会直接报错退出,不会静默降级 —— 与其跑出一个行为诡异的站点,不如一开始就说清楚。

安装

  1. 把程序包解压到站点的目录里(整个包放一起,别把里面的文件拆散)。
  2. 把域名的 网站根目录指向其中的 wwwroot/ —— 对外访问的是这个子目录,网址里不会出现 wwwroot。
  3. 用浏览器访问域名,自动进入安装向导。要填三项:
    1. 站点类型:正式站或演示站,决定初始内容与配色
    2. 管理员账号:用户名 3–20 位字母数字下划线,密码至少 6 位
    3. 数据库:默认用 SQLite,直接下一步即可

也可以走命令行安装 —— 适合脚本化部署、批量建站,或者本机装了 PHP 想先试一遍。 前提是执行命令的那台机器上有 PHP,并且命令指向站点里的 install.php:

php install.php --cli --profile=cms --user=admin --pass=你的密码

安装程序做了什么

  • 建表、写入初始内容、生成管理员账号
  • 生成 config/config.php,其中包含一份随机密钥
  • 把数据库文件放在 站点根目录之外,并随机命名

第三点是刻意的:数据库不在网站目录里,HTTP 无论如何也访问不到;文件名随机,即使有人按常见路径去猜也猜不中。

装完立刻做三件事

  1. 删除或改名 install.php。程序会拒绝重复安装,但留着没有意义。
  2. 到 站点设置 填好站点名称、域名、备案号、联系方式。
  3. 到 用户管理 确认管理员密码足够强,并考虑开启登录二次验证。
权限提醒:如果后续用命令行执行安装或升级,请以站点用户身份执行,不要用 root。 否则数据库与缓存目录会变成 root 所有,网页进程写不进去, 表现出来就是「能打开页面,但一保存就报错」。
没找到答案? 可以在 联系我们 留言说明使用场景,我们会补充进文档。