场景介绍

  • 案例一:ISV三方企业小程序的回调地址必须是公网域名或IP,对于大部分开发者来说,开发者无法在本地调试远程代码,对于回调URL校验不通过之类的问题无法追踪,只能不断远程部署查看log日志来调试修改。
  • 案例二:企业通讯录同步过程中需要注册一个公网域名(或IP)的回调地址,用来接收钉钉上的企业通讯录信息变更。
  • 内网穿透工具可以实现将一个公网域名映射到本地的localhost域名。

启动内网穿透

  • 1.下载工具 git clone https://github.com/open-dingtalk/pierced.git
  • 启动工具,执行命令“./ding -config=./ding.cfg -subdomain=域名前缀 端口”,以mac为例:
    cd mac_64
    chmod 777 ./ding
    ./ding -config=./ding.cfg -subdomain=abcde 8080

    命令参数说明:

  • -config 内网穿透的配置文件,按命令照示例固定为钉钉提供的./ding.cfg,无需修改
  • -subdomain 您需要使用的域名前缀,该前缀将会匹配到“vaiwan.com”前面,例如你的subdomain是abcde,启动工具后会将abcde.vaiwan.com映射到本地。
  • 端口 您需要代理的本地服务http-server端口,例如你本地端口为8080等

  • 2.启动完客户端后,你访问http://abcde.vaiwan.com/xxxxx都会映射到 http://127.0.0.1:8080/xxxxx

  • 文档地址:https://ding-doc.dingtalk.com/doc#/kn6zg7/hb7000
  • 仓库地址:https://github.com/open-dingtalk/pierced.git