如何通过本地Postman调用远程服务器本地服务API及配置SSH隧道?
配置Postman SSH隧道调用远程服务器本地服务API
方式一:直接在Postman内配置SSH隧道
- 打开Postman,点击右上角齿轮状的设置图标,选择「Settings」。
- 左侧菜单选「Proxy」,找到「SSH Tunnel」板块。
- 勾选「Enable SSH Tunnel」开启隧道功能。
- 填写SSH基础连接信息:
- Host: 远程服务器的IP地址或域名
- Port: SSH服务端口,默认填22即可
- User: 远程服务器的登录用户名
- Authentication: 选对应认证方式:
- 用密码的话选「Password」,填入登录密码
- 用密钥的话选「SSH Key」,点击「Browse」选择本地私钥文件(比如
~/.ssh/id_rsa),私钥有密码的话补充填写「Passphrase」
- 添加端口转发规则:点击「Add」按钮,填入:
- Source Port: 本地空闲端口(比如8080,确保没被其他程序占用)
- Destination: 远程服务器上服务的地址+端口,格式为
localhost:服务端口(比如服务跑在远程的127.0.0.1:3000,就填localhost:3000)
- 点击「Save」保存配置。
- 之后在Postman里发送请求时,直接访问
http://localhost:你设置的Source Port,就能转发到远程服务的API接口。
方式二:用系统SSH命令建立端口转发(更稳定)
如果Postman内置隧道不好用,先通过命令行建立本地转发,再用Postman访问:
- 打开本地终端(Windows用PowerShell/CMD,Mac/Linux用Terminal),执行命令:
示例:ssh -L 本地端口:localhost:远程服务端口 用户名@远程服务器IP
这条命令的作用是:把本地8080端口的请求,通过SSH隧道转发到远程服务器的localhost:3000端口。ssh -L 8080:localhost:3000 user@192.168.1.100 - 执行后输入SSH登录密码(用密钥的话加
-i 私钥文件路径参数),保持终端窗口处于打开状态。 - 打开Postman,直接发送请求到
http://localhost:8080/你的API路径即可调用远程服务。
常见问题排查
- 先确认本地能正常通过SSH登录远程服务器(执行
ssh 用户名@远程IP测试),确保SSH服务正常运行。 - 本地Source Port不能被占用,用
netstat -ano | findstr 端口号(Windows)或lsof -i :端口号(Mac/Linux)检查。 - 用密钥认证时,Linux/Mac下要确保私钥文件权限为
chmod 600 私钥文件,避免权限过高导致无法读取。
内容的提问来源于stack exchange,提问作者Deeksha Sharma
相关产品推荐
相关产品推荐

