Deployment
How to Deploy
部署方法
For a detailed, step-by-step deployment guide (Cloudflare Workers / EdgeOne / ESA), see OpenList Worker 部署指南.
详细的分步部署指南（Cloudflare Workers / EdgeOne / ESA）请参阅 OpenList Worker 部署指南。
One-click Deploy
一键部署
| EdgeOne 国际站 | EdgeOne 中国站 | Cloudflare Workers |
|---|---|---|
 | |
Note: If Cloudflare reports "unable to fetch repository content", Fork the project first, then deploy via the GitHub repository connection. ::::
注意：若 Cloudflare 提示"无法获取存储库内容"，请先 Fork 本项目，再通过连接到 GitHub 仓库功能部署。 ::::
For platform-specific step-by-step guides, see:
各平台的分步部署教程，请参阅：
Initialization
部署后初始化
TIP
After deployment, the first visit to the site automatically enters an install wizard. Set the admin account and password in the browser to complete initialization — no pre-configured ADMIN_PASSWORD is required.
TIP
部署完成后，首次访问站点会自动进入安装向导，在浏览器中设置管理员账号与密码即可完成初始化，无需预先配置 ADMIN_PASSWORD。
Local Development
本地开发
Prerequisites
- Node.js 18+ (pnpm recommended)
- A Cloudflare account (for deploying to Workers)
Local development
# 1. Install dependencies
pnpm install
# 2. Configure wrangler.toml (fill in JWT_SECRET, KV/D1 bindings)
# 3. Start the dev server (auto fetch the official frontend and run the Worker)
pnpm run dev:unified
# or run the Worker only (frontend built separately)
pnpm run dev:workerProduction deploy
# One-click deploy: ensure KV namespace exists → fetch official frontend → deploy to Cloudflare Workers
pnpm run deploy
# or deploy the Worker directly (skip KV check and frontend build)
pnpm run deploy:worker前置要求
- Node.js 18+（推荐使用 pnpm）
- Cloudflare 账号（用于部署到 Workers）
本地开发
# 1. 安装依赖
pnpm install
# 2. 配置 wrangler.toml（填写 JWT_SECRET、KV/D1 绑定）
# 3. 启动开发服务器（自动拉取官方前端并运行 Worker）
pnpm run dev:unified
# 或仅运行 Worker（不拉取前端）
pnpm run dev:worker生产部署
# 一键部署：确保 KV namespace 存在 → 拉取官方前端 → 部署到 Cloudflare Workers
pnpm run deploy
# 或直接部署 Worker（跳过 KV 检查与前端构建）
pnpm run deploy:worker