标签 EdgeOne Pages 下的文章

部署到 Cloudflare Workers

fork 本存储库：Fork xixu-me/Xget
获取 Cloudflare 凭证：
- 访问账户 API 令牌创建并记录 API 令牌，使用“编辑 Cloudflare Workers”模板
- 访问 Workers 和 Pages 记录 Account ID
配置 GitHub Secrets：
- 进入你的 GitHub 存储库 → Settings → Secrets and variables → Actions
- 添加以下 secrets：
  - CLOUDFLARE_API_TOKEN：你的 API 令牌
  - CLOUDFLARE_ACCOUNT_ID：你的 Account ID
触发部署：
- 推送代码到 main 分支会自动触发部署
- 仅修改文档文件（.md）、LICENSE、.gitignore 等不会触发部署
- 也可以在 GitHub Actions 页面手动触发部署
绑定自定义域名（可选）：在 Cloudflare Workers 控制台中绑定你的自定义域名

部署到 Cloudflare Pages

fork 本存储库：Fork xixu-me/Xget
获取 Cloudflare 凭证：
- 访问账户 API 令牌创建并记录 API 令牌，使用“编辑 Cloudflare Workers”模板
- 访问 Workers 和 Pages 记录 Account ID
配置 GitHub Secrets：
- 进入你的 GitHub 存储库 → Settings → Secrets and variables → Actions
- 添加以下 secrets：
  - CLOUDFLARE_API_TOKEN：你的 API 令牌
  - CLOUDFLARE_ACCOUNT_ID：你的 Account ID
触发部署：
- 存储库会自动将 Workers 代码转换为 Pages 兼容格式并同步到 pages 分支
- 推送代码到 main 分支会自动触发同步和部署工作流
- 仅修改文档文件（.md）、LICENSE、.gitignore 等不会触发部署
- 也可以在 GitHub Actions 页面手动触发部署
绑定自定义域名（可选）：在 Cloudflare Pages 控制台中绑定你的自定义域名

注意：pages 分支是从 main 分支自动生成的。请勿手动编辑 pages 分支，因为它会被同步工作流覆盖。

部署到 EdgeOne Pages

fork 本存储库：Fork xixu-me/Xget
获取 EdgeOne Pages API Token：
- 访问中国站 EdgeOne 控制台或国际站 EdgeOne 控制台创建并记录 API Token
配置 GitHub Secrets：
- 进入你的 GitHub 存储库 → Settings → Secrets and variables → Actions
- 添加以下 secret：
  - EDGEONE_API_TOKEN：你的 API Token
触发部署：
- 存储库会自动将 Workers 代码转换为 Pages 兼容格式并同步到 pages 分支
- 推送代码到 main 分支会自动触发同步和部署工作流
- 仅修改文档文件（.md）、LICENSE、.gitignore 等不会触发部署
- 也可以在 GitHub Actions 页面手动触发部署
绑定自定义域名（可选）：在 EdgeOne Pages 控制台中绑定你的自定义域名

注意：pages 分支是从 main 分支自动生成的。请勿手动编辑 pages 分支，因为它会被同步工作流覆盖。

部署到 Vercel

fork 本存储库：Fork xixu-me/Xget
获取 Vercel 凭证：
- 访问 Vercel Account Settings 创建并记录 Access Token
- 访问 Team Settings 记录 Team ID
- 新建项目后访问项目的 Settings 记录 Project ID
配置 GitHub Secrets：
- 进入你的 GitHub 存储库 → Settings → Secrets and variables → Actions
- 添加以下 secrets：
  - VERCEL_TOKEN：你的 Access Token
  - VERCEL_ORG_ID：你的 Team ID
  - VERCEL_PROJECT_ID：你的 Project ID
触发部署：
- 存储库会自动将 Workers 代码转换为 Functions 兼容格式并同步到 functions 分支
- 推送代码到 main 分支会自动触发同步和部署工作流
- 仅修改文档文件（.md）、LICENSE、.gitignore 等不会触发部署
- 也可以在 GitHub Actions 页面手动触发部署
绑定自定义域名（可选）：在 Vercel 控制台中绑定你的自定义域名

注意：functions 分支是从 main 分支自动生成的。请勿手动编辑 functions 分支，因为它会被同步工作流覆盖。

部署到 Netlify

fork 本存储库：Fork xixu-me/Xget
获取 Netlify 凭证：
- 访问 Netlify User Settings 创建并记录 personal access token
- 新建项目后访问 Project configuration 记录 Project ID
配置 GitHub Secrets：
- 进入你的 GitHub 存储库 → Settings → Secrets and variables → Actions
- 添加以下 secrets：
  - NETLIFY_AUTH_TOKEN：你的 personal access token
  - NETLIFY_SITE_ID：你的 Project ID
触发部署：
- 存储库会自动将 Workers 代码转换为 Functions 兼容格式并同步到 functions 分支
- 推送代码到 main 分支会自动触发同步和部署工作流
- 仅修改文档文件（.md）、LICENSE、.gitignore 等不会触发部署
- 也可以在 GitHub Actions 页面手动触发部署
绑定自定义域名（可选）：在 Netlify 控制台中绑定你的自定义域名

注意：functions 分支是从 main 分支自动生成的。请勿手动编辑 functions 分支，因为它会被同步工作流覆盖。

部署到 Deno Deploy

fork 本存储库：Fork xixu-me/Xget
切换默认分支：
- 进入你的 GitHub 存储库 → Settings → General → Default branch
- 将默认分支从 main 切换到 functions
部署到 Deno Deploy：
- 参考 Deno Deploy 官方文档执行部署
- 在 Deno Deploy 控制台创建新项目并连接你的 GitHub 存储库
绑定自定义域名（可选）：在 Deno Deploy 控制台中绑定你的自定义域名

注意：functions 分支是从 main 分支自动生成的。请勿手动编辑 functions 分支，因为它会被同步工作流覆盖。

自托管部署

如果你希望在自己的服务器上运行 Xget，可以使用 Docker 或 Podman 部署：

使用预构建镜像

从 GitHub Container Registry 拉取并运行预构建的镜像：

使用 Docker:

# 拉取最新镜像
docker pull ghcr.io/xixu-me/xget:latest

# 运行容器
docker run -d \
  --name xget \
  -p 8080:8080 \
  ghcr.io/xixu-me/xget:latest

使用 Podman:

# 拉取最新镜像
podman pull ghcr.io/xixu-me/xget:latest

# 运行容器
podman run -d \
  --name xget \
  -p 8080:8080 \
  ghcr.io/xixu-me/xget:latest

本地构建

从源码构建容器镜像：

使用 Docker:

# 克隆存储库
git clone https://github.com/xixu-me/Xget.git
cd Xget

# 构建镜像
docker build -t xget:local .

# 运行容器
docker run -d \
  --name xget \
  -p 8080:8080 \
  xget:local

使用 Podman:

# 克隆存储库
git clone https://github.com/xixu-me/Xget.git
cd Xget

# 构建镜像
podman build -t xget:local .

# 运行容器
podman run -d \
  --name xget \
  -p 8080:8080 \
  xget:local

使用 Docker Compose / Podman Compose

创建 docker-compose.yml 文件：

version: '3.8' services: xget:  ghcr.io/xixu-me/xget:latest container_name: xget ports: - "8080:8080" restart: unless-stopped

使用 Docker Compose:

docker compose up -d

使用 Podman Compose:

podman compose up -d

部署完成后，Xget 将在 8080 端口运行。

注意：自托管部署不包括全球边缘网络加速，性能取决于你的服务器配置和网络环境。

📌 转载信息

来源： https://linux.do/t/topic/1513719

原作者： xixu-me

转载时间： 2026/1/25 23:15:14

起因

前些时间整了个备案域名，就想着把一些自建服务迁移回国内，原本我的 Bark 服务器是放在 Cloudflare Workers 上的，于是就想着看看能不能迁移到国内公有云的 Serverless 平台上。

选择 EdgeOne Pages 的原因也很简单，想着也许能够免费用，于是就遇到第一个问题：

问题

问题 1：文档没有描述 KV 的计费规则

我打开腾讯云的文档竟然发现完全没有描述 Pages KV 的计费规则，于是我提出售前工单询问计费规则，客服回复让我加微信群问技术支持……所以这个工单系统的作用是什么，电话总机吗？无奈还是加群问了下，技术支持表示是免费的。就算免费也得写一下吧……那好吧就用这个了，毕竟好像找不到第二个免费的……

问题 2: CLI 中环境变量不能设置为 0

设置环境变量为 0 表示禁用应该是挺常见的用法，一开始设置为 0 不行觉得可能是 JavaScript 0 == '' 的问题（后面一想那参数肯定是字符串啊），于是就试着设置成 "0"，还是不行。在网页试了下可以设置，不过难道把环境变量设置为空字符串又是什么禁忌吗？

> npx edgeone pages env set EXAMPLE_KEY 0
[cli][✘] Variable name and value cannot be empty.
> npx edgeone pages env set EXAMPLE_KEY ""
[cli][✘] Variable name and value cannot be empty.
> npx edgeone pages env set EXAMPLE_KEY "0"
[cli][✘] Variable name and value cannot be empty.

问题 3：启动开发环境次数有日限

这个文档里写了，但是没写能开多少次，我这边大概不到 20 次就触发日限额了（热重载不算，但是 Debug 的时候发现热重载不是很即时就反复开了下），只能等第二天。

这个开发环境似乎是远程在腾讯云那边起了三个 Worker ，而且对 KV 的读写会影响到生产环境（这要是真有人在重要生产环境用了怕不是会炸掉）……

问题 4：fetch() 不支持 HTTP/2

最后的推送代码写好的时候，发现请求 APNs 服务器的时候连接会被断开，研究半天发现是 EdgeOne Pages Edge Functions Runtime 的 fetch() 不支持 HTTP/2 ，而 api.push.apple.com 是强制使用 HTTP/2 的。我问了下腾讯的员工，说是在规划中，本来我想着可能我是第一个发现的文档没有提示也不奇怪，后面发现似乎我不是第一个问这个的……

本来觉得又白干一天了，突然想起这个 Edge Pages 还有个 Node Functions 用的是 Node.js Runtime ，于是拿 Node Functions 写了个代理就勉强能用了。开发的过程中发现 Edge Functions 的 Catch-all 路由优先级是高于 Node Functions 所有路由的，只好把 Edge Functions 移动到了一个单独的目录下，当然这文档也没说明。

总结

总而言之，头疼的体验主要来自文档不清晰，其次交流严重依赖 IM 而不是工单系统，最后是非常草台的设计。