O96u
c9c34515dd
GitHub Release / release (push) Canceled after 0s
Publish Docker image / build (linux/amd64, ubuntu-latest, amd64) (push) Canceled after 0s
Publish Docker image / build (linux/arm64, ubuntu-24.04-arm, arm64) (push) Canceled after 0s
Publish Docker image / merge (push) Canceled after 0s
ci / ci (22, ubuntu-latest) (push) Canceled after 0s
修复设置页误清空管理域、配置与生效 URL 混淆及第三 Host 绕过隔离；加固 Settings API 与中间件，并更新文档站。
55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
# 本地开发
|
||
|
||
在仓库根目录进行 Nuxt 4 全栈开发，数据默认写入 `./data`。
|
||
|
||
## 环境要求
|
||
|
||
- Node.js **22**
|
||
- npm **11**（与 `package.json` 中 `packageManager` 一致）
|
||
|
||
## 启动
|
||
|
||
```bash
|
||
npm install
|
||
cp .env.example .env # 可选
|
||
npm run dev
|
||
```
|
||
|
||
访问 `http://localhost:3000/setup` 创建管理员。数据目录默认 `./data`（`DATA_DIR` 可改）。
|
||
|
||
## 常用命令
|
||
|
||
| 命令 | 说明 |
|
||
| ---- | ---- |
|
||
| `npm run dev` | 开发服务器 |
|
||
| `npm run build` | 生产构建 |
|
||
| `npm run start` | 运行 `.output` |
|
||
| `npm run lint` | ESLint |
|
||
| `npm run typecheck` | 类型检查 |
|
||
| `npm test` | 单元测试 |
|
||
| `npm run reset-password` | 重置密码（可选用户名） |
|
||
| `npm run migrate` | 预览遗留目录迁移（加 `-- --apply` 执行） |
|
||
|
||
## 开发专用环境变量
|
||
|
||
| 变量 | 说明 |
|
||
| ---- | ---- |
|
||
| `DEV_BYPASS_ACCESS` | 设为 `true` 可绕过登录（跳过 `/setup`，一般无需开启） |
|
||
| `DATA_DIR` | 数据目录，默认 `./data` |
|
||
|
||
完整变量列表见 [环境变量](./configuration.md)。
|
||
|
||
## 双域名本地测试
|
||
|
||
修改系统 `hosts` 后可用两个测试域名验证分离逻辑，步骤见 [双域名分离](./domain-separation.md#本地测试-windows-macos)。
|
||
|
||
## 文档站
|
||
|
||
```bash
|
||
npm run docs:dev # VitePress 开发
|
||
npm run docs:build # 构建静态站点
|
||
npm run docs:preview # 预览构建结果
|
||
```
|
||
|
||
文档源码在 `docs-site/`；截图源文件在 `docs/screenshots/`（含 `login.png` 登录页），构建前会复制到 `docs-site/public/screenshots/`。在线文档：<https://o96u.github.io/PicHost/>
|