第五十二天

今日核心任务：解决本地服务公网访问问题，完成内网穿透部署，让飞书开放平台能够成功回调本地项目接口，为飞书应用、机器人对接打下网络基础。

技术难点与踩坑全过程

项目本地运行在固定端口，仅支持局域网访问，飞书平台的事件回调、接口请求均来自公网，默认无法穿透本地防火墙和局域网限制，这是飞书应用对接的首要壁垒。

起初我使用简易内网穿透工具进行调试，首次配置看似成功，生成了公网临时域名，但测试飞书接口回调时频繁出现连接超时、端口丢失问题。排查后发现两大坑点：一是临时穿透工具稳定性极差，长时间运行会自动断连，无法满足项目持续运行需求；二是默认生成的HTTP协议域名，不满足飞书平台HTTPS安全校验规则，平台直接拦截所有回调请求。

为解决稳定性和协议合规问题，我更换方案，采用标准化穿透+证书适配的方式优化：

1. 重新配置穿透映射，固定项目运行端口，关闭端口随机跳转配置，保证服务地址唯一稳定；
​
2. 适配HTTPS协议，解决飞书平台安全校验拦截问题；
​
3. 开启后台守护进程，防止穿透服务挂机、断连，保障24小时稳定传输。

整个调试过程耗时最久的是端口冲突与权限报错。本地多个开发项目占用端口，导致穿透映射反复失败，需要逐一排查端口占用进程，手动终止冲突程序，重新绑定专属端口。同时服务器防火墙默认拦截公网入站请求，需要手动开放端口白名单，放行飞书官方服务IP。

经过反复调试、测试、重启服务，最终成功实现稳定内网穿透：公网域名可正常访问本地项目接口，飞书平台能够成功连接本地服务，彻底打通了公网与内网的通信通道。

今日开发成果

1. 彻底解决内网穿透不稳定、协议不合法、端口冲突三大问题；
​
2. 搭建稳定的公网访问通道，本地项目接口可被飞书平台正常调用；
​
3. 完成飞书应用基础配置，绑定公网回调地址，为后续跨域和代理配置铺路。