为世界所有美好而战

数据流架构#

1
用户浏览器                    Cloudflare 边缘                 你的电脑（内网）
2
https://open.xxx.eu.cc  →  DNS 解析 + TLS 终止  →  cloudflared  →  OpenList
3
                                                  (Tunnel 客户端)   (127.0.0.1:5544)

Windows（你的环境）#

方式一：winget 安装（推荐）

1
winget install Cloudflare.cloudflared

方式二：手动下载

1. 访问 cloudflared GitHub Releases
2. 下载 cloudflared-windows-amd64.msi
3. 双击安装

安装后验证：

1
cloudflared --version

建议使用 v2024.0.0 及以上版本。

其他系统（参考）#

mac:

1
brew install cloudflared

配置项说明#

IMPORTANT

1. service 必须用 127.0.0.1，不要用 localhost<br> localhost 是一个域名，Cloudflare 边缘节点在某些情况下会尝试对其进行 DNS 解析，导致 Error 1016 Origin DNS error。使用 127.0.0.1 纯 IP 地址可彻底避免此问题。<br> 2. 最后一条 ingress 必须是 catch-all 规则 <br> 不含 hostname 字段，否则 cloudflared 拒绝启动。<br> 3. credentials-file 必须使用绝对路径 <br> Windows 上不要用相对路径，写出完整路径。

前台运行（首次调试用）#

1
cloudflared tunnel run openlist

看到以下输出说明成功：

1
INF Starting tunnel tunnelID=a1b2c3d4-e5f6-7890-abcd-ef1234567890
2
INF Route registered for open.xxx.eu.cc
3
INF Connection registered connIndex=0 location=SJC
4
INF Connection registered connIndex=1 location=LAX
5
INF Connection registered connIndex=2 location=SEA
6
INF Connection registered connIndex=3 location=IAD

cloudflared 默认建立 4 条冗余连接到不同边缘节点，自动故障切换。

此时不要关闭这个 CMD 窗口，关闭 = 杀掉进程 = 隧道断开。后续设置为 Windows 服务后可解决此问题。

确保 OpenList Desktop 也开机自启#

1. 按 Win + R 输入 shell:startup 回车
2. 将 OpenList Desktop 的快捷方式拖入该文件夹
3. 右键 OpenList Desktop 快捷方式 → 属性 → 兼容性 → 勾选”以管理员身份运行”

start.vbs/注册cloudflared.exe Windows 服务#

方案一：创建vbs启动脚本

这个方法是使用.vbs自启动后在后台作为系统服务运行，会产生需要手动关闭的CMD窗口。

• 在Cloudflare.exe同级目录下新建文件 start.txt文本文档并输入以下内容：

1
Set WshShell = CreateObject("WScript.Shell")
2
' ==========================================
3
' 配置区域：请根据实际路径修改下方引号内的内容
4
' ==========================================
5
Dim exePath, exeCmd
6

7
' cloudflared.exe 的完整绝对路径
8
exePath = "D:\Openalist\cloudflared\cloudflared.exe" /*将路径替换为你实际的 cloudflared 路径。*/
9

10
' 需要执行的命令参数
11
exeCmd = "tunnel run openlist-tunnel"
12

13
' ==========================================
14
' 执行命令
15
' 参数说明: 0 表示隐藏窗口, False 表示不等待程序结束(这样即使vbs结束,服务也在运行)
16
' ==========================================
17
WshShell.Run """" & exePath & """ " & exeCmd, 0, False
18

19
Set WshShell = Nothing

WARNING

注意将所有路径替换为个人实际路径

• 保存文本文档并重新命名为：start.vbs
• 键入win+r打开运行框，输入shell:startup回车，将start.vbs拖入该文件夹。

方案二：注册cloudflared.exe Windows 服务

这个方法会让 cloudflared 在后台作为系统服务运行，开机自动启动，无需手动干预，且不会留下需要手动关闭的CMD窗口。

• 在开始菜单搜索 CMD 或PowerShell ，右键点击，选择“以管理员身份运行”。
• 使用 cd 命令切换到你的 cloudflared.exe 所在的文件夹。根据你的情况，应该是：

1
cd /d D:\Openalist\

• 运行以下服务安装命令，将 cloudflared 注册为系统服务。这个命令会自动读取你已有的配置文件（config.yml）。

1
.\cloudflared.exe service install

• 验证服务状态 安装成功后，你可以打开“服务”管理器来验证。 按下 Win + R 键，输入 services.msc 并回车。 在服务列表中找到名为 Cloudflared 的服务。 你会看到它的“启动类型”是“自动”，并且“状态”是“正在运行”。
• 完成以上步骤后，(首次安装)你就可以关闭 CMD 窗口了。cloudflared 隧道会在后台持续稳定运行，并且每次开机都会自动启动。

4. 开机后的完整启动流程

1
电脑开机
2
  ↓
3
OpenList Desktop 自动启动 → 监听 127.0.0.1:5544
4
  ↓
5
Cloudflared 服务自动启动 → 建立 Tunnel 隧道
6
  ↓
7
约 30 秒后 → https://open.xxx.eu.cc 可访问

openlist/cloudflared.exe都要设置自启，缺一不可。#

9.1 Cloudflare Access 保护#

为 OpenList 添加身份验证，未授权用户看到登录页面：

1. 进入 Zero Trust → Access → Applications → Add an application → Self-hosted
2. Application name：OpenList
3. Session Duration：24 hours
4. Application domain：open.xxx.eu.cc
5. Policy 规则示例：
   • If Emails ending in @xxx.com → Allow
   • Else → Block

9.2 SSL 模式设置#

进入 域名 → SSL/TLS → Overview：

• 如果 cloudflared 到 OpenList 用的是 http://127.0.0.1（无 TLS）→ 选择 Full
• 如果本地也配了 TLS 证书 → 选择 Full (Strict)

9.3 其他建议#

Error 1016 Origin DNS error#

现象：浏览器显示 Error 1016 Origin DNS error，Cloudflare 无法解析域名。

原因：

1. config.yml 中 service 使用了 localhost 而非 127.0.0.1
2. 根域名被错误地加入了 Tunnel 路由

解决：

1
# 错误写法
2
service: http://localhost:5544
3

4
# 正确写法
5
service: http://127.0.0.1:5544

同时删除 Tunnel 路由中的根域名条目，只保留子域名。

502 Bad Gateway#

现象：Cloudflare 能解析域名但无法连接后端。

排查步骤：

1
REM 1. 确认 OpenList 正在运行
2
curl http://127.0.0.1:5544
3

4
REM 2. 确认 cloudflared 正在运行
5
nssm status CloudflaredTunnel
6

7
REM 3. 检查 config.yml 中端口号是否匹配 OpenList 实际监听端口

ERR_TOO_MANY_REDIRECTS（重定向循环）#

原因：OpenList 配置了强制 HTTPS，但 Cloudflare SSL 模式不匹配。

解决：将 Cloudflare SSL/TLS 模式设为 Full（非 Strict）。因为 cloudflared 到 localhost 是明文 HTTP，不是 TLS。

下载速度慢 / 超时#

• Cloudflare 免费版对单文件大小有一定限制
• 在 Cloudflare → Speed → Optimization 中关闭 Rocket Loader、Mirage 等
• 检查 cloudflared 日志是否有频繁断连重连
• 大文件（>100MB）场景需考虑其他方案

error reading config: invalid ingress rule#

原因：YAML 格式错误。

常见原因：

• 使用了 Tab 缩进（必须用空格）
• 缺少最后的 catch-all ingress 规则
• hostname 多了空格或少了后缀

建议：用 YAML Lint 在线校验格式。

如何更换域名 / 添加多个域名#

1. 修改 config.yml，在 ingress 中添加新的 hostname + service 条目
2. 执行 cloudflared tunnel route dns openlist 新域名.xxx.eu.cc
3. 重启服务：nssm restart CloudflaredTunnel

示例：

1
ingress:
2
  - hostname: open.xxx.eu.cc
3
    service: http://127.0.0.1:5544
4
  - hostname: files.xxx.eu.cc
5
    service: http://127.0.0.1:5544
6
  - service: http_status:404