首页 / 开发文档 / 环境要求与安装

环境要求与安装

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

服务器要求

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

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

安装

把程序包解压到站点根目录,让浏览器访问该域名,会自动进入安装向导。需要填写三项:

  1. 站点类型:正式站或演示站,决定初始内容与配色
  2. 管理员账号:用户名 3–20 位字母数字下划线,密码至少 6 位
  3. 数据库:默认用 SQLite,直接下一步即可

也可以走命令行,适合脚本化部署:

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

安装程序做了什么

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

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

装完立刻做三件事

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