安装依赖与生成客户配置

本章目标

安装锁定依赖，生成仅属于本站的随机密钥。

操作步骤

在源码根目录执行，先确认 Node.js 24 与 pnpm 11.1.3 可用。若全局版本不同，用你信任的 Node.js 包管理方式安装项目指定版本。

cd /www/wwwroot/yume-site
pnpm install --frozen-lockfile
pnpm customer:configure

customer:configure 读取 .env.customer.example，生成新的 .env 和随机密钥。已有 .env 时命令会停止，不会覆盖现有配置；已有站点请进入更新章节。

文件与目录权限

让运行服务的账号能够读取源码和 .env，并写入项目需要的 uploads 与私有 .local 存储目录。不要给整个目录设置 777。配置文件应仅对管理和运行服务账号开放。

完成检查

依赖安装成功，根目录出现 .env。下一章填写真实数据库、域名与管理员信息。

常见错误

依赖安装失败先检查 Node.js、pnpm 版本、网络和锁文件。不要为了绕过错误删除锁文件或上传 Windows 的 node_modules 到 Linux。