安装与部署

源码获取与授权、安装启动和部署配置相关问题。

源码获取与授权

“我的授权”中没有 Nexus

确认当前登录账号与购买账号一致。如果刚完成购买，可以刷新页面后再次检查；仍未出现时联系交付方核对订单与授权发放状态。

点击下载后提示达到授权上限

交付包允许的下载次数由所购商品决定。停止重复尝试，并联系交付方核对已经完成的下载记录。

源码下载的完整操作见源码获取。

安装与启动

依赖安装失败

• 使用 Node ≥ 20（推荐 22 LTS）。
• 先保留 package-lock.json，执行 npm ci 复现项目锁定的依赖版本；日常开发可执行 npm install。
• 只有确认本地 node_modules 损坏时才删除它后重装。不要把删除锁文件作为默认排障步骤，否则可能引入整批依赖升级。
• 若使用代理或私有源，确认 npm registry 可达。

数据库初始化问题

• 本地开发：npx drizzle-kit migrate 需在 NUXT_DATABASE_URL 指向的库可达时执行。
• Docker 模式：迁移由应用启动自动执行，无需手动 migrate；若迁移报错，检查 NUXT_DATABASE_URL 是否正确（容器内连宿主机库用 host.docker.internal）。

端口冲突

• 应用默认 :3000。被占用时改 docker-compose*.yml 端口映射（如 "3001:3000"），并同步 NUXT_APP_URL 端口。
• 快速开始中的开发数据库映射到 5433。如果该端口也被占用，可换成其他宿主机端口，并同步修改 NUXT_DATABASE_URL。

多语言与 SEO

hreflang / sitemap 域名不对

根因通常是 NUXT_APP_URL 与访问域名不一致。改为浏览器实际访问地址（含协议与端口，如 https://your.domain）后重新构建。