在深入了解编译过程之前，我们先要回答一个问题：为什么放着官方现成的客户端不用，非要自己编译？
官方提供的 ngrok 服务虽然方便，但它有几个天然的局限。首先，官方服务器的海外节点往往导致访问速度不稳定，尤其是当你需要频繁传输数据时。其次，免费版无法绑定你自己的域名，每次生成的随机地址既不专业也不方便记忆。更关键的是，出于安全策略，很多企业内部网络会限制对国外服务器的访问。
而通过自己编译，你完全可以搭建一套专属的 ngrok 服务端。这套系统运行在你自己的云服务器上，流量不再经过官方中转，速度由你的服务器性能决定。你可以绑定自己拥有的任何域名，甚至可以实现更细粒度的访问控制和流量管理。对于有安全合规要求的企业场景，自建方案更是唯一的选择。
编译的本质，就是将 ngrok 的源代码转化成可以在不同操作系统上直接运行的可执行程序。这个过程，就像是把一份通用乐高图纸，拼装成一台真正能跑的机器。
编译前的准备：三大核心要素
在正式开始编译之前，你需要准备好三样东西，缺一不可。
第一，一台拥有公网 IP 的云服务器。
这是你自建 ngrok 服务的“根据地”。你可以选择阿里云、腾讯云、华为云或 AWS 等任意一家云服务商，购买一台最低配置的 Linux 服务器即可，操作系统推荐 CentOS 7 或 Ubuntu。这台服务器的公网 IP 将成为所有穿透流量的入口。
第二，一个属于你自己的域名。
域名是外界访问你服务的“门牌号”。你需要将一个域名（或者更常见的做法是，一个域名的二级子域名，比如 ngrok.yourdomain.com）通过 DNS 解析，指向你那台云服务器的公网 IP。这里有一个关键操作：你需要配置泛解析。也就是说，不但要将 ngrok.yourdomain.com 指向服务器，还要将 *.ngrok.yourdomain.com 也指向同一台服务器。这样，当你为不同的本地服务分配不同的子域名（比如 a.ngrok.yourdomain.com 和 b.ngrok.yourdomain.com）时，它们都能被正确地路由到你的服务器上。
第三，基础软件环境。
你的云服务器需要安装 Git 来拉取源代码，安装 Golang 环境来编译程序，同时还需要 Make 和 Openssl 等基础编译工具。这些在 Linux 系统中都可以通过简单的命令完成安装。
编译的核心步骤：从代码到可执行文件
当你准备好上述所有条件后，真正的编译工作就开始了。整个过程可以分为几个清晰的阶段，你可以将其理解为一条标准化的流水线。
第一步：获取源码并生成专属证书
首先，你需要通过 Git 命令将 ngrok 的源代码从全球开发者社区克隆到你的云服务器上。代码到手后，紧接着最重要的一步是生成 SSL 安全证书。由于你搭建的是自己的服务，你需要扮演“证书颁发机构”的角色，为你的域名生成一套自签名的证书。这套证书将用于加密客户端与服务器之间的通信，确保数据在传输过程中不被窃取或篡改。
这里需要特别注意的是，生成证书时要用到的核心域名，必须和你之前解析的那个域名完全一致。证书生成后，你需要用它们替换掉源代码中自带的测试用证书文件。
第二步：配置编译环境
ngrok 是用 Go 语言编写的，因此你需要设置一些环境变量来告诉编译系统应该如何工作。最关键的一个变量是 NGROK_DOMAIN，你需要将它设置为你的域名。这个变量会贯穿整个编译过程，确保生成的服务端和客户端都“认识”这个地址。
第三步：执行编译命令
这是整个流程的中心环节。在 ngrok 的源代码目录下，你可以通过不同的命令来生成不同用途的程序。
编译服务端：执行编译服务端的命令后，你会得到一个名为 ngrokd 的可执行文件。这个文件就是你要在云服务器上运行的核心程序，负责监听来自公网的请求并将其转发到你的内网客户端。
编译客户端：这是 ngrok 最灵活的特性之一——交叉编译。你完全不需要在 Windows 电脑或 Mac 电脑上重新搭建一遍编译环境。你只需要在云服务器上，通过改变 GOOS 和 GOARCH 这两个环境变量的值，就可以直接编译出能在你本地电脑上运行的客户端程序。例如，指定 GOOS=windows 就能生成 Windows 下的 ngrok.exe 文件；指定 GOOS=darwin 则生成 Mac 下的客户端。编译完成后，你只需要用 FTP 工具或 SCP 命令将这些客户端文件下载到你的本地电脑上即可。
整个编译过程就像在一台机器上同时制造了发动机（服务端）和不同型号的车钥匙（适配不同操作系统的客户端）。
不同操作系统下的编译要点
虽然编译的核心逻辑是一样的，但针对不同的操作系统，还是有一些细节需要注意。
在 Linux 服务器上编译是最标准的流程。你需要确保 Go 语言的版本不要太低，同时由于编译过程中需要从国外网站下载一些依赖库，网络不稳定时可能会失败，多尝试几次通常就能解决。
如果你希望在 Windows 上直接编译，也是完全可以的。你需要先在 Windows 系统中安装 Go 语言环境和 Git 工具。然后打开命令行工具，设置好环境变量，再执行编译命令。不过相比之下，利用 Linux 服务器进行交叉编译仍然是更主流、更顺畅的选择，因为 ngrok 的原始开发环境就是 Linux。
特别注意，在编译客户端时，请务必搞清楚你本地电脑的操作系统版本。如果你的 Windows 是 64 位的，就需要指定 GOARCH=amd64；如果是 32 位的，则需要指定 GOARCH=386。选错了，生成的程序将无法在你的电脑上运行。
编译完成后的工作：部署与启动
编译成功只是第一步，你还需要让这些程序真正“跑”起来。
首先，在你的云服务器上，运行刚刚生成的 ngrokd 服务端程序。启动时需要通过参数指定你之前生成的证书文件路径、域名以及服务监听的端口。通常，你需要让这个服务在后台持续运行，即使你关闭了 SSH 连接也不会中断。
与此同时，不要忘记在云服务器的防火墙或安全组规则中，放行 ngrok 需要用到的端口。默认情况下，隧道端口是 4443，而 HTTP 和 HTTPS 的默认端口是 80 和 443。如果你的服务器上已经有网站占用了这些端口，你需要在这里指定其他未被占用的端口号。
最后，在你自己的电脑上，只需要创建一个简单的配置文件，里面写明你的服务器地址和端口，然后双击运行下载好的客户端程序，并通过命令行参数指定你想要映射的本地端口号。比如，你正在本地开发一个使用 3000 端口的网站，就可以通过命令将本地 3000 端口与 ngrok 隧道绑定。当一切正常工作时，你就可以通过 任意名字.你的域名 来访问你本地的服务了。
常见问题与避坑指南
在编译和部署的过程中，有几个“坑”是很多人都会遇到的，提前了解可以为你节省大量时间。
域名解析未生效：这是最基础也最容易忽略的问题。在开始编译前，务必确认你的域名泛解析已经生效。你可以通过 ping 一个不存在的子域名来测试，看是否能解析到你服务器的 IP。
编译时卡住不动：编译过程常常会卡在下载依赖包的步骤。这通常是因为你的服务器无法稳定访问国外代码仓库。解决方法是耐心多试几次，或者为你的服务器配置更稳定的网络访问通道。
客户端连接失败：如果你在本地运行客户端时提示连接错误，请检查三件事：第一，客户端配置文件中的服务器地址是否写对了端口；第二，云服务器的防火墙是否开放了 4443 这个隧道端口；第三，你启动服务端时指定的 -tunnelAddr 参数端口是否与客户端配置一致。
证书不匹配：如果你在连接时遇到证书错误，说明客户端正在尝试用官方的证书来验证你自建的服务器。请检查你生成证书后，是否正确地覆盖了源代码目录中的证书文件，并且是在覆盖之后才执行的编译命令。
总的来说，编译 ngrok 虽然涉及到命令行操作，但其流程是清晰且固定的。一旦你成功走过一遍这个流程，你收获的将不仅仅是一个内网穿透工具，更是一种对网络原理和跨平台编译技术的更深理解。这对于任何需要在开发和运维工作中频繁处理网络问题的开发者来说，都是一项非常有价值的技能。
对于新手而言，市面上也有许多功能类似的工具，如80km穿云箭https://www.80km.com/cyj/，对新手友好，可以做到以下
1、内网端口映射
将内网 Web、SSH、RDP、数据库等服务一键映射至公网，无需公网 IP、无需路由器端口转发。
2、动态域名绑定
支持自定义二级域名或绑定自有域名，域名自动跟随公网 IP 变化更新，永不掉线。
3、多协议支持
HTTP/HTTPS/TCP/UDP 全协议穿透，Web 服务、游戏联机、远程桌面、摄像头监控均适用。
4、P2P 智能加速
端到端直连优先，数据不经中转节点，低延迟、高带宽，传输更稳定。
5、安全隧道加密
采用 TLS/SSL 加密通道与访问鉴权机制，防止非法访问与流量劫持。
