当前位置:首页 > 随笔 > 正文内容

在 macOS Monterey 上通过 Docker 解决钉钉内网穿透工具运行失败问题

访客 随笔 2026年9月16日 11

问题背景

钉钉提供的内网穿透工具 pierced 基于 Go 语言开发,用于将本地服务映射到公网进行调试。然而,在 macOS Monterey 系统中直接运行该工具时,会遇到如下致命错误:

fatal error: runtime: bsdthread_register error

runtime stack:
runtime.throw(0x14bd408, 0x21)
    /usr/local/go/src/runtime/panic.go:619 +0x81
runtime.goenvs()
    /usr/local/go/src/runtime/os_darwin.go:129 +0x83
...

此问题源于部分旧版 Go 编译的二进制文件与 macOS 12(Monterey)及以上系统的线程注册机制存在兼容性问题。由于钉钉官方已长期未更新该工具,原始方案无法正常工作。

解决方案概述

利用 Docker 容器化技术绕过系统级兼容性限制。通过构建 Linux 环境容器并运行适用于 Linux 的 ding 工具,实现功能等效的内网穿透服务。

操作步骤

1. 安装 Docker

前往 Docker 官方文档 下载并安装 Docker Desktop for Mac,确保后台服务正常运行。

2. 准备项目结构

假设工具存放路径为:/opt/pierced,进入目录并组织以下结构:

cd /opt/pierced
mkdir -p linux mac_64 windows_64
cp mac_64/ding.cfg linux/ding.cfg
cp mac_64/ding linux/ding

3. 创建启动脚本

编写容器内执行的启动脚本:

cat > linux/run.sh <<'EOF'
#!/bin/bash
echo "Starting tunnel: $ADDRESS => $DOMAIN"
/pierced/ding --config=/pierced/ding.cfg --subdomain=$DOMAIN $ADDRESS
EOF

chmod +x linux/run.sh

4. 编写 Dockerfile

定义镜像构建流程:

FROM ubuntu:20.04
LABEL maintainer="community-solution"

WORKDIR /pierced
COPY linux/ .
RUN chmod +x run.sh

ARG subdomain
ENV DOMAIN=$subdomain

ARG addr
ENV ADDRESS=$addr

CMD ["./run.sh"]

5. 配置 Makefile 简化操作

提升构建和运行效率:

build:
	docker build -t ding-tunnel:latest \
	--build-arg subdomain=$(subdomain) \
	--build-arg addr=$(addr) .

run:
	docker run --name ding-tunnel -d ding-tunnel:latest

logs:
	docker logs -f ding-tunnel

clean:
	docker rm -f ding-tunnel || true

.PHONY: build run logs clean

6. 构建镜像

根据实际参数执行构建:

make build subdomain=myapp addr=192.168.10.10:8080
  • myapp:希望绑定的子域名
  • 192.168.10.10:8080:本地运行服务的 IP 与端口(必须指定主机 IP)

7. 启动隧道服务

make run

查看日志确认连接状态:

make logs

访问验证

成功后可通过以下地址访问本地服务:

http://myapp.vaiwan.com

流量将被安全转发至本地 192.168.10.10:8080。

补充说明

该方法本质是通过容器环境隔离系统差异,核心依赖来自开源社区贡献的跨平台适配思路。若后续官方更新支持新版 macOS,可直接使用原生版本。

标签: Docker

相关文章

可以按小时收费的VPS

很多 VPS 提供商都支持 按小时计费(hourly billing),想短期试用 / 临时搭建节点、测试网络、短期项目等场景非常合适。下面是当前最主流且靠谱的按小时 VPS 选项,分别按不同需求场景整理: 1. Vultr(全球节点,包括日本) 按小时计费 可选机房:东京 / 大阪 / 洛杉矶 / 法兰克福 / 伦敦 … 支持 PayPal(部分情况),但更常用信用卡/PayPal+卡价格参考$...

在 iPhone 上下载国外App

地区/国家限制App Store 会根据 Apple ID 的国家或地区限制应用下载。如果你的 Apple ID 绑定的是中国大陆,就可能无法下载 OpenAI 官方的 ChatGPT 应用,因为它在大陆 App Store 不上架。解决办法:换成美国、加拿大、香港等地区的 Apple ID。或者在现有 Apple ID 上更改地区。注册一个国外 Apple ID(推荐)比如注册 美国区 Appl...

Node.js 中的异步编程:回调与 Promise

Node.js 是一个基于 JavaScript 构建的单线程、非阻塞运行环境,它通过异步编程机制来高效处理多个操作。在执行如文件读取、API 请求或数据库查询等任务时,Node.js 不会等待这些操作完成,而是使用回调函数和 Promise 来避免阻塞主线程。 回调方式实现异步 那么当异步操作完成后,Node.js 如何知道接下来要做什么呢?这就要用到 回调函数(callback)。 回调本质上...

Selenium自动化测试入门指南

Selenium自动化测试入门指南

什么是自动化测试? 自动化测试是指利用软件工具自动执行测试用例,模拟用户操作,如打开网页、点击链接、输入文本等,并验证结果是否符合预期。 其主要优点包括: 大幅减少人工成本 测试速度快 可以在非工作时间运行 支持持续集成和交付 然而,它也存在一些局限性,例如开发成本较高、不适合快速变化的项目、依赖稳定的UI界面等。 自动化测试的应用条件 适合引入自动化测试的情况包括: 手动测试耗时且需要大量...

MariaDB Galera集群故障快速恢复指南

OpenStack控制节点采用三节点MariaDB Galera集群架构。当数据库集群因故障重启时,有时会出现Galera集群无法正常启动的问题。虽然有多种方法可以恢复数据库服务,但如何实现快速启动同时确保数据完整性呢? 通过分析日志发现,MariaDB Galera集群节点宕机时会在日志中输出以下信息: [Note] WSREP: 新集群视图:全局状态: 874d8e7e-5980-11e8-8...

Android 中 EventBus 的通信机制与实现原理深度解析

EventBus 核心设计思想 EventBus 是一个基于观察者模式的事件总线框架,广泛应用于 Android 平台以实现组件解耦。它通过中心化的消息分发机制,使不同层级、不同线程的对象能够以"发布-订阅"方式通信,避免了传统接口回调或广播带来的强依赖问题。 核心角色说明 事件(Event):任意 Java 对象,作为数据载体,如网络状态变更通知、用户登录信息等。 发布者(Publi...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。