安装文档
三步向导装完即用。以下内容整理自程序随附运维手册，与正式版 v1.4.85 对应。
环境要求
- PHP ≥ 7.4，扩展：pdo_sqlite（或 pdo_mysql）、mbstring、openssl、fileinfo、gd、curl
- 目录可写：
storage/、config/、public/uploads/（缺失时安装向导自动创建） - 可选：ffmpeg（用于波形、试听与 MV 转码；无 ffmpeg 自动降级，不影响使用）
安装向导（三步）
- 上传解压 —— 把安装包上传到站点目录（zip 解压 / git clone 常丢空目录，向导会自动补建并校验可写）
- 访问 install.php —— 浏览器打开
http://你的域名/install.php：环境检查 → 数据库（SQLite 零配置或 MySQL）→ 创建管理员 - 完成 —— 生成
config/database.php与storage/app/installed.lock，install.php 自动失效并跳回首页
安全策略：已存在
installed.lock 时拒绝任何 POST 重装请求，防止攻击者把数据源指向外部数据库。重新安装需先删除 config/database.php 与 storage/app/installed.lock。本地开发
cd neondeck/public
php -S 127.0.0.1:8899 router.php- 必须指定
router.php，否则静态资源与路由全 404 - 开发模式下验证码直接显示在页面（
mail_enabled=0时邮件全文落盘storage/logs/），无邮件环境也能走通注册 / 找回全流程
生产部署
- 标准模式 —— Nginx / Apache 站点根目录指向
public/，伪静态：try_files $uri $uri/ /index.php?$query_string; - 根目录模式（宝塔友好） —— 不改运行目录时，项目根已内置
index.php / admin.php / install.php / router.php四个转发入口，按包内nginx-root.conf.example粘贴规则即可
常见坑：根目录模式下
/assets/ 与 /uploads/ 两条 rewrite 缺一不可——少了 /uploads/ 会导致封面全部 404，深色主题下看起来像「整站空白」。升级已有站点
php migrate.php # 结构升级，幂等可重复跑- 或后台「授权与更新 → 一键更新」：自动备份 → 覆盖 → 自动跑迁移，失败可回滚
- 覆盖主程序时务必保留
config/与storage/ - 务必带上
app/bootstrap.php与app/Core/View.php，必要时重启 PHP-FPM 清 OPcache
装完之后
- 后台
http://你的域名/admin.php—— 曲库审核 / 用户 / 财务 / 论坛 / 站点编辑 / 扩展 / 授权与更新 - 设置 → 支付通道：填好密钥并把异步通知地址配置到网关商户后台（
/pay/notify/{channel}） - 扩展 → 插件 / 主题：广告位、友情链接、七牛 / R2 云存储等 zip 即装