Atlassian Forge Tunnel无法运行，如何调试排查？

• Mac OS Big Sur 11.7.10
• Node v18.15.0
• Docker 24.0.6
• Forge 7.0.2

我用forge create创建了全新应用，执行forge tunnel命令时，输出以下内容后就卡住不动了：

Tunnel redirects requests you make to your local machine. This occurs for any Atlassian site where your app is installed in the specific development environment. You will not see requests from other users.

Press Ctrl+C to cancel.

当前没有VPN、防火墙或代理在运行，Docker Desktop已安装并处于运行状态。请问有哪些排查方法？或者怎么获取详细日志来调试？

Docker info返回内容（中文翻译版）：

客户端:
 版本:    24.0.6
 上下文:    desktop-linux
 调试模式: 关闭
 插件:
  buildx: Docker Buildx (Docker 官方)
    版本:  v0.11.2-desktop.5
    路径:     /Users/my_username/.docker/cli-plugins/docker-buildx
  compose: Docker Compose (Docker 官方)
    版本:  v2.22.0-desktop.2
    路径:     /Users/my_username/.docker/cli-plugins/docker-compose
  dev: Docker 开发环境 (Docker 官方)
    版本:  v0.1.0
    路径:     /Users/my_username/.docker/cli-plugins/docker-dev
  extension: Docker 扩展管理 (Docker 官方)
    版本:  v0.2.20
    路径:     /Users/my_username/.docker/cli-plugins/docker-extension
  init: 为项目创建 Docker 相关启动文件 (Docker 官方)
    版本:  v0.1.0-beta.8
    路径:     /Users/my_username/.docker/cli-plugins/docker-init
  sbom: 查看镜像的基于包的软件物料清单(SBOM) (Anchore 官方)
    版本:  0.6.0
    路径:     /Users/my_username/.docker/cli-plugins/docker-sbom
  scan: Docker 扫描 (Docker 官方)
    版本:  v0.26.0
    路径:     /Users/my_username/.docker/cli-plugins/docker-scan
  scout: Docker Scout (Docker 官方)
    版本:  v1.0.7
    路径:     /Users/my_username/.docker/cli-plugins/docker-scout

服务端:
 容器数: 1
  运行中: 0
  暂停中: 0
  已停止: 1
 镜像数: 2
 服务端版本: 24.0.6
 存储驱动: overlay2
  底层文件系统: extfs
  支持 d_type: 是
  使用元拷贝: 否
  原生覆盖差分: 是
  userxattr: 否
 日志驱动: json-file
 Cgroup 驱动: cgroupfs
 Cgroup 版本: 2
 插件:
  存储卷: local
  网络: bridge host ipvlan macvlan null overlay
  日志: awslogs fluentd gcplogs gelf journald json-file local logentries splunk syslog
 Swarm: 未激活
 运行时: io.containerd.runc.v2 runc
 默认运行时: runc
 初始化二进制文件: docker-init
 containerd 版本: 8165feabfdfe38c65b599c4993d227328c231fca
 runc 版本: v1.1.8-0-g82f18fe
 init 版本: de40ad0
 安全选项:
  seccomp
   配置文件: 无限制
  cgroupns
 内核版本: 6.4.16-linuxkit
 操作系统: Docker Desktop
 系统类型: linux
 架构: x86_64
 CPU: 8核
 总内存: 7.672GiB
 名称: docker-desktop
 ID: 9644cbbe-d113-4fa3-a7df-0f91f9bc52ba
 Docker 根目录: /var/lib/docker
 调试模式: 关闭
 HTTP 代理: http.docker.internal:3128
 HTTPS 代理: http.docker.internal:3128
 无需代理: hubproxy.docker.internal
 实验特性: 关闭
 不安全镜像仓库:
  hubproxy.docker.internal:5555
  127.0.0.0/8
 实时恢复: 关闭

警告: 守护进程未使用默认 seccomp 配置文件

一、获取详细调试日志 #

执行tunnel命令时添加--verbose参数，输出内部连接、Docker交互等细节：

forge tunnel --verbose

或者开启Forge全局调试模式后再运行：

export FORGE_DEBUG=true
forge tunnel

二、检查Docker状态与镜像拉取 #

1. 手动拉取Forge隧道镜像，验证Docker网络是否正常：

   docker pull atlassian/forge-tunnel:latest
   

   若拉取失败，检查Docker镜像仓库配置或网络连通性。
2. 清理异常Forge容器后重试：

   docker rm -f $(docker ps -aq --filter "name=forge-tunnel")
   forge tunnel
   

三、验证Forge配置与登录状态 #

1. 重新登录Forge，确保凭证有效：

   forge login
   

2. 验证应用配置文件合法性：

   forge validate
   

   检查manifest.yml中modules、app.id等配置是否存在语法错误。

四、环境变量与系统设置检查 #

1. 临时清空代理变量测试：
   Docker输出显示存在自动代理配置，尝试清空后运行：

   unset HTTP_PROXY
   unset HTTPS_PROXY
   forge tunnel
   

2. 确认MacOS防火墙未拦截请求：
   前往「系统偏好设置 -> 安全与隐私 -> 防火墙」，临时关闭防火墙后重试tunnel命令。

五、版本兼容性测试 #

1. 降级Forge CLI版本：
   尝试切换到稳定版6.x：

   npm install -g @forge/cli@6.0.0
   forge tunnel
   

2. 切换Node版本：
   用nvm切换到Node 16 LTS版本测试：

   nvm install 16
   nvm use 16
   forge tunnel
   

内容的提问来源于stack exchange，提问作者Snowman