记沉

树莓派1Panel面板Cloudflare Tunnel内网穿透配置指南

4/25/2026 1Panel

# 树莓派1Panel面板Cloudflare Tunnel内网穿透配置指南

# 一、准备工作

# 1.1 硬件准备

  • 树莓派设备（推荐树莓派3B+及以上型号）
  • 电源适配器
  • MicroSD卡（建议16GB以上）
  • 网线或WiFi连接

# 1.2 系统安装

  1. 下载Raspberry Pi Imager工具
  2. 选择Raspberry Pi OS（建议使用64位版本）
  3. 写入SD卡并启动树莓派

# 二、获取树莓派局域网IP

# 2.1 通过路由器管理后台查找

  1. 登录路由器管理界面（通常为192.168.1.1或192.168.0.1）
  2. 在"已连接设备"或"DHCP客户端列表"中查找树莓派设备
  3. 记录树莓派的局域网IP地址（如：192.168.31.87）

# 2.2 通过局域网扫描工具

  1. 使用Advanced IP Scanner、Angry IP Scanner等工具扫描局域网
  2. 查找树莓派设备并记录IP地址

# 三、SSH连接树莓派

# 3.1 使用Termius连接

  1. 打开Termius应用
  2. 点击"Hosts" → "New Host"
  3. 填写连接信息：
    • Host: 树莓派局域网IP地址
    • Port: 22
    • Username: pi（默认用户名）
    • Password: raspberry（默认密码）
  4. 点击"Connect"建立连接

# 3.2 使用其他SSH工具

  • Windows：PuTTY、Windows Terminal
  • macOS/Linux：终端直接使用ssh命令
  • 命令格式：ssh pi@192.168.31.87

# 四、安装1Panel面板

# 4.1 一键安装命令

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

也可以：

  1. 访问 1Panel官网 (opens new window)，查找一键安装命令。
  2. 在SSH终端中执行安装命令。
  3. 安装过程中，按提示完成相关配置。

# 4.2 自定义端口设置

在安装过程中设置1Panel端口为8002：

  1. 安装脚本会提示设置面板端口
  2. 输入8002作为自定义端口
  3. 设置强密码作为面板访问密码

# 4.3 访问1Panel面板

安装完成后，通过浏览器访问：

http://<树莓派局域网IP>:8002

首次访问需要使用安装时设置的密码登录。

# 五、安装Cloudflare Tunnel客户端

# 5.1 在1Panel应用商店安装

  1. 登录1Panel面板
  2. 点击左侧"应用商店"
  3. 搜索"cloudflared"或"Cloudflare Tunnel"
  4. 点击"安装"按钮

# 5.2 配置Cloudflare Token

  1. 在Cloudflare官网创建API Token
    • 权限：Tunnel:Edit, Account:Read
  2. 在1Panel的cloudflared应用配置中：
    • 填写Cloudflare邮箱
    • 填写API Token
    • 保存配置

# 六、配置Cloudflare Tunnel

# 6.1 创建Tunnel

  1. 登录Cloudflare Zero Trust后台
  2. 进入"Networks" → "Tunnels"
  3. 点击"Create a tunnel"
  4. 输入Tunnel名称并创建

# 6.2 配置Public Hostname

  1. 在Tunnel管理页面点击"Public Hostname"
  2. 点击"Add a public hostname"
  3. 配置信息：
    • Hostname: 选择或输入子域名（如：panel.yourdomain.com）
    • Service: 选择"HTTP"
    • URL: http://192.168.31.87:8002（使用树莓派局域网IP+8002端口）
  4. 保存配置

# 七、访问测试

# 7.1 外网访问测试

  1. 在外部网络环境下
  2. 通过浏览器访问配置的子域名
  3. 如：https://panel.yourdomain.com
  4. 应能正常打开1Panel面板界面

# 7.2 功能验证

  1. 检查面板基本功能是否正常
  2. 测试"终端"功能是否可用
  3. 验证文件管理、应用部署等功能

# 八、注意事项

# 8.1 网络稳定性

  • 确保树莓派网络连接稳定
  • 建议使用有线连接而非WiFi
  • 定期检查Tunnel连接状态

# 8.2 安全设置

  • 定期更新1Panel面板
  • 使用强密码保护面板访问
  • 配置防火墙规则限制访问

# 8.3 故障排查

常见问题及解决：

  • 502错误：检查Tunnel配置的IP地址是否正确
  • 连接超时：检查树莓派防火墙是否放行8002端口
  • WebSocket失败：确保使用局域网IP而非localhost

# 九、总结

通过以上步骤，您已成功配置树莓派1Panel面板的Cloudflare Tunnel内网穿透，实现了：

  • 安全的远程访问
  • 稳定的连接通道
  • 完整的功能支持

现在您可以在任何有网络的地方，通过子域名安全地管理您的树莓派设备了！