---
title: frp v0.70：开源内网穿透工具教程，完善 API、规定兼容性策略
date: 2026-07-12T08:50:48Z
modified: 2026-07-12T08:50:53Z
permalink: "https://www.appinn.com/frp/"
type: post
status: publish
excerpt: ""
categories:
  - macOS
  - Windows
  - 网络工具
tags:
  - macOS
  - Windows
  - 网络工具
  - frp
  - 内网穿透
  - 开源
  - 教程
featured_image: "https://www.appinn.com/wp-content/uploads/2019/08/frp1.jpgo_.jpg"
author: 青小蛙
timestamp: 2026-07-12T08:50:53Z
---

frp v0.70 更新，完成了 frps 的 Dashboard API v2 迁移、提升了 WebSocket/WSS 兼容性、修复了 Proxy Protocol 问题。v0.69 还规定了新的兼容性策略。@Appinn

![](https://www.appinn.com/wp-content/uploads/2026/04/CleanShot-2026-07-12-at-16.26.01@2x.avif)

## frp v0.70

这个版本主要继续推进 **frps Dashboard API v2** 的迁移，新增并完善了客户端、代理、服务器概览、客户端详情、代理详情等模块，支持分页、搜索、按代理类型筛选、代理流量历史、服务器系统信息等能力。

其他更新：

- **WebSocket**：WebSocket/WSS 改为发送 Binary Frame，提升与 Cloudflare、Nginx 等代理的兼容性，避免因 UTF-8 检查导致连接断开。
- **Proxy Protocol**：修复 `tls2raw` 插件启用 Proxy Protocol 时未正确写入 Header 的问题。
- **配置检查**：配置中出现重复的 Proxy 或 Visitor 名称时，将直接报错，不再静默覆盖。

## frp v0.69兼容性策略

在此前的 **v0.69** 中，官方首次公布了版本兼容策略。

以 **v0.69** 为例，官方保证 **frpc v0.69** 可以与 **v0.61～v0.77** 的 **frps** 相互兼容（反之亦然）。超出这个范围后，官方不再保证兼容性，但在很多情况下仍可能正常工作。

对于混合版本部署，官方建议**先升级 frps，再升级 frpc**，这样服务器可以提前兼容新客户端的协议行为，整个升级过程也更加平滑。

## frp v0.68

frp 的这个新功能，青小蛙觉得，就是为 AI 准备的。

## 持久化存储功能

在 frpc **客户端**配置中，添加`[store]`即可开启**内置存储功能**，将配置保存在 db.json 文件中：


serverAddr = "127.0.0.1" # frps 服务端IP地址
serverPort = 端口
auth.token = "appinn" # 密钥

webServer.addr = "0.0.0.0"
webServer.port = 7500
webServer.user = "appinn"
webServer.password = "appinnadmin"

[store]
path = "./db.json"


注意需要同时开启 webServer 之后，才能使用 API 功能。

## API 功能

通过 API 修改后的 frpc 无需重启，立即生效。

实际上，API 的相关操作只需要交给 AI 即可，不过这里有几个例子：

### 用终端将 OpenClaw 添加到 frp：


$ curl -u appinn:appinnadmin http://192.168.1.111:7500/api/store/proxies \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openclaw",
    "type": "tcp",
    "tcp": {
      "localPort": 17321,
      "remotePort": 47321
    }
  }'


之后，该代理就会出现在 frp 客户端中：

![](https://static3cdn.appinn.com/images/2025/08/Screenshot-2026-04-14-06.05.20@2x.avif)

### 修改代理

不小心用错了端口，只需要使用下嘛的命令，即可把 17321 端口替换为 18789：


curl -u appinn:appinnadmin -X PUT \
  http://192.168.1.111:7500/api/store/proxies/openclaw \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openclaw",
    "type": "tcp",
    "tcp": {
      "localPort": 18789,
      "remotePort": 6000
    }
  }'


### 删除代理

不想要了，只需要使用如下命令：


curl -u appinn:appinnadmin -X DELETE http://192.168.1.111:7500/api/store/proxies/openclaw


### 查询所有代理


curl -u appinn:appinnadmin http://192.168.1.111:7500/api/store/proxies


---

以下内容为2025年8月14日更新。

[frp](https://www.appinn.com/frp.md) 是一款跨平台的内网穿透工具，支持 Windows、macOS 与 Linux，它需要你有一台拥有固定公网 IP 的电脑，VPS 最好，然后就能愉快的进行内网穿透了。还支持 https，甚至可以用它进行小程序开发。@Appinn

## v0.64.0 新增 **tokenSource** 支持

2025年8月10日，frp v0.64.0 更新1个主要功能：

- 新增 **tokenSource** 支持，允许从文件中加载认证 token，而不是直接在配置文件中写死，避免了在配置文件中直接暴露 token 的风险。

此外，v0.64.0 还修复了 SSH 隧道网关错误绑定地址的问题，提升了连接的稳定性和可用性。

![](https://static2.appinn.com/images/201908/frp1.jpg)

网络的本地本来是应该互联互通的，但各种各样的原因会导致互联互不通。于是就需要造轮子解决它，frp 就是这样一个轮子，开源、免费、简单易用。

当然，免费意味着你需要自备一款拥有固定公网 IP 的电脑/VPS 作为中转节点。这台电脑可以是拥有固定公网 IP 的任意电脑，也可以自配一台 VPS，青小蛙依旧推荐 [Vultr](https://www.vultr.com/?ref=7872434-4F) 的机器，便宜好用，控制面板简单。

> 另外通过青小蛙的[推荐链接注册](https://www.vultr.com/?ref=7112193)（👈有返利），还送 50 刀体验金，仅限新用户。Vultr 推荐美国、德国的机器。如果不嫌麻烦，也可以试试 [阿里云](https://promotion.aliyun.com/ntms/yunparter/invite.html?userCode=tqir5sme) 的机器，优点肯定是连接响应速度快了，但带宽略小。

这里假设你已经有一台 VPS 了，只需要跟着步骤走即可：

## 设置 frp 服务器

1. 根据系统[下载程序](https://github.com/fatedier/frp/releases)，并解压缩
2. 将 **frps** 及 **frps.toml** 放到具有[公网 IP 的机器](https://www.vultr.com/?ref=7872434-4F)上
3. 创建 token 文件，内容就是你的密钥

青小蛙目前所用的 frps.toml 文件内容：


bindPort = 1723

auth.tokenSource.type = "file"
auth.tokenSource.file.path = "/etc/frp/token"

webServer.addr = "0.0.0.0"
webServer.port = 7500
webServer.user = "用户名"
webServer.password = "密码"

allowPorts = [
  { start = 7001, end = 7010 }
]


最后一行是青小蛙打开了 7001～7010 几个端口。

新建 /etc/frp/token 文件，内容直接添加你自定义的密钥即可，你可以把它理解为 frp 之间互相联系的口令。

### 运行：


./frps -c ./frps.toml


另外，针对 Linux 用户，[这里](https://gist.github.com/ihipop/4dc607caef7c874209521b10d18e35af)有一个后台运行服务可以参考。以上为 Linux 系统的执行命令，如果是 Windows 系统：


c:\Tools\frp\frps.exe -c c:\Tools\frp\frps.toml


假设 frps 解压缩到了 **c:\\Tools\\frp\\** 文件夹。

以及，请让防火墙通过 7000 端口，以及 7001、7002 端口。

## 设置 frp 客户端

1. 根据系统[下载程序](https://github.com/fatedier/frp/releases)
2. 将 **frpc** 及 **frpc.toml** 放到处于内网环境的机器上。

这里以 Windows 远程桌面、群晖管理界面为例，修改 **frpc.toml** 配置文件：


serverAddr = 服务器公网 IP
serverPort = 1723

auth.tokenSource.type = "file"
auth.tokenSource.file.path = "C:\Tools\frp\token"

[RDP]
type = tcp
local_ip = 127.0.0.1
local_port = 3389
remote_port = 7001
 
[DSM]
type = tcp
local_ip = 群晖在局域网中的 IP 地址
local_port = 5000
remote_port = 7002


别忘记创建 token 文件，内容和之前服务器上的内容相同。另外 remote\_port 中的端口需要在服务器中打开（allowPorts 字段）

然后，启动 Windows 命令提示符，运行：


c:\Tools\frp\frpc.exe -c c:\Tools\frp\frpc.toml


这里假设你的 frp 解压缩到了 **C:\\Tools\\frp\\** 文件夹下。

![](https://static2.appinn.com/images/201908/2019-08-254-15-40.jpg)

如果看到两行 **start proxy success** 就代表成功了。

## 远程访问

此时，就可以在外网访问网内资源了。

比如远程桌面，只需要打开微软的远程桌面客户端，然后使用 **公网IP:7001** 即可连接。

比如群晖，只需要打开浏览器，在地址栏输入 **公网IP:7002** 即可访问 DSM 的管理界面。

## 其它配置

frp 官网提供了非常详尽的[说明书](https://github.com/fatedier/frp/blob/master/README_zh.md#%E4%B8%BA%E6%9C%AC%E5%9C%B0-http-%E6%9C%8D%E5%8A%A1%E5%90%AF%E7%94%A8-https)，包括转发 ssh、http、https、转发 Unix 域套接字等等，都可以配置使用。

但，其实对于初学者来说，还是有点费劲的。

## 更多示例

青小蛙开了[一个帖子](https://meta.appinn.net/t/frp/11319)，准备连载一些 frp 的示例，以及如果在 Windows 下以系统服务运行 frp 等等一些内容。感兴趣的同学可以前往参考、讨论、分享。

目前有两个示例：

- [授权访问，让 frp 更安全](https://meta.appinn.net/t/frp/11319/2?u=qingwa)
- [Windows 下如何让 frp 以系统服务的方式运行](https://meta.appinn.net/t/frp/11319/3?u=qingwa)

没错，你遇到了坑，也欢迎分享下来，尤其错误代码，大家一起解决。

## Topics

**分类目录:** [macOS](https://www.appinn.com/category/mac/?output_format=md), [Windows](https://www.appinn.com/category/windows/?output_format=md), [网络工具](https://www.appinn.com/category/net/?output_format=md)

**标签:** [frp](https://www.appinn.com/tag/frp/?output_format=md), [内网穿透](https://www.appinn.com/tag/%e5%86%85%e7%bd%91%e7%a9%bf%e9%80%8f/?output_format=md), [开源](https://www.appinn.com/tag/%e5%bc%80%e6%ba%90/?output_format=md), [教程](https://www.appinn.com/tag/%e6%95%99%e7%a8%8b/?output_format=md)