W WinnaCMS

安装指南

浏览: 3

WinnaCMS 安装包已包含运行依赖（vendor），按以下步骤即可部署上线。以下命令以 Linux 虚拟主机/云服务器为例。

一、系统要求

  • PHP 8.4 及以上（实测 8.4.27），扩展：openssl、pdo_mysql、mbstring、fileinfo、curl、gd 或 imagick、zip。
  • MySQL 8.0+ 或 MariaDB 10.6+。
  • Nginx 或 Apache，需支持 URL 重写，站点根目录指向 /public。
  • PHP 限制：upload_max_filesize ≥ 20M、post_max_size ≥ 25M、memory_limit ≥ 256M。
  • 磁盘空间：程序约 100MB，建议预留 5GB 以上用于媒体与备份。

二、上传与目录

  1. 把安装包解压到站点目录，例如 ~/apps/wincms。
  2. 把域名根目录指向 ~/apps/wincms/public。
  3. 确保 storage 与 bootstrap/cache 可写。

三、环境文件

cp deploy/env.production .env
php artisan key:generate

至少填写：APP_URL、DB_HOST/DB_PORT/DB_DATABASE/DB_USERNAME/DB_PASSWORD、CRON_TOKEN、邮件相关 MAIL_*。所有密钥只保存在服务器 .env，不要提交到代码仓库。

四、运行安装向导

浏览器打开 https://你的域名/install，按向导完成：环境检测 → 数据库连接 → 管理员账号 → 选装模块 → 确认安装。安装完成后可删除或重命名 /install 目录。

五、定时任务

虚拟主机没有系统 crontab 时，在面板添加 URL 计划任务：每 1–5 分钟访问 https://你的域名/cron/{CRON_TOKEN}。该入口会驱动定时发布与队列；CRON_TOKEN 留空则入口整体 404。

六、安装后

php artisan optimize

首次登录后请立即修改管理员口令。后续升级在后台「系统更新」中检查，更新包带签名校验，可查看版本历史并回滚。

七、GEO 模块（可选）

在后台「模块市场」安装 GEO 平台，然后在「GEO 配置」填写授权码。授权与域名绑定，试用授权可联系 sales@winna-group.com 申请。

八、安装登记

安装完成后，WinnaCMS 会自动向官方登记一次站点基本信息：域名、CMS 版本、PHP/数据库版本、服务器环境、管理员邮箱、安装时间。信息仅用于授权跟进与更新服务，不包含密码、密钥或内容数据。如需关闭，在 .env 设置 INSTALL_REPORT_ENABLED=false；上报失败会在每日心跳时自动重试。

九、升级与备份

核心升级会自动备份数据库；模块/主题升级会执行数据库迁移，数据库不会自动回滚。升级前请在「系统更新」页点「立即备份数据库」，并自行备份 public/media、public/uploads 等上传文件，然后勾选「我已备份」再提交升级。