OpenFRP 客户端在 Linux 上的安装与使用教程

前言

OpenFRP 是一个优秀且免费的内网穿透工具，可以帮助我们轻松地将本地服务（如网站、SSH、远程桌面、游戏服务器等）暴露到公网上，方便随时随地访问。

本教程旨在为 Linux 用户提供一份清晰、详尽的 OpenFRP 客户端安装和使用指南，覆盖了命令行 (CLI) 和图形化 (GUI) 两种模式，适用于服务器和个人桌面环境。

准备工作

在开始之前，请确保您已准备好以下几项：

一台 Linux 设备：可以是云服务器（如 Ubuntu, CentOS）或装有 Linux 发行版的个人电脑。
网络连接：确保您的设备可以访问互联网以下载所需文件。
OpenFRP 账户：您需要注册一个 OpenFRP 账户，并登录到管理面板。
用户密钥 (Token) 和隧道 ID：在 OpenFRP 管理面板中，您需要：
- 在 “密钥” 页面找到您的账户密钥。
- 在 “隧道” 页面创建一个隧道，并获取其 ID。

一、命令行 (CLI) 版本安装 (适用于服务器环境)

命令行版本轻量、高效，非常适合在没有图形界面的服务器上 24/7 运行。

步骤 1：获取最新客户端版本号

OpenFRP 的客户端版本会不断更新。为了确保最佳性能和安全性，建议始终使用最新版本。

访问官方版本信息接口：
https://api.openfrp.net/commonQuery/get?key=software
在该页面中，使用 Ctrl+F 搜索关键字 latest_full。您会找到类似下面的一行：
1
"latest_full": "OF_0.61.1_4df06100_250122"
这里的 "OF_0.61.1_4df06100_250122" 就是我们需要的最新版本号。请复制它。`

步骤 2：下载客户端

使用 wget 命令下载对应您系统架构的客户端压缩包。请将下面的 <版本号> 替换为您在上一步中获取的实际版本号。

对于 AMD/Intel 64位架构：

wget "https://r.zyghit.cn/download/client/<版本号>/frpc_linux_amd64.tar.gz"

# 示例 (使用教程编写时的版本号)
# wget "https://r.zyghit.cn/download/client/OF_0.61.1_4df06100_250122/frpc_linux_amd64.tar.gz"

步骤 3：解压文件

下载完成后，使用 tar 命令解压文件。

1 2	# 替换为你的实际文件名 tar -zxvf frpc_linux_amd64.tar.gz

解压后，您会得到一个名为 frpc_linux_amd64 的可执行文件。

步驟 4：赋予执行权限

为了能够运行该文件，需要使用 chmod 命令为其添加执行权限。

1 2	# 替换为你的实际文件名 chmod +x frpc_linux_amd64

步骤 5：运行客户端

现在，一切准备就绪。使用以下命令启动 OpenFRP 客户端。

请将 你的用户密钥 和 你的隧道ID 替换为您在 OpenFRP 管理面板获取的真实信息。

1	./frpc_linux_amd64 -u 你的用户密钥 -p 你的隧道ID

如果一切正常，您将看到日志输出，表明客户端已成功连接到服务器，隧道建立成功！

二、图形化 (GUI) 桌面版本安装 (适用于个人桌面环境)

对于使用 Linux 桌面的用户，OpenFRP 提供了跨平台的图形化启动器，操作更直观。

步骤 1：下载 AppImage 文件

官方图形化启动器 (OpenFrp-CrossPlatformLauncher) 请访问OpenFrp官网复制其下载链接

使用 wget 下载（请注意将链接替换为最新版本）：

1	wget https://r.zyghit.cn/download/ofcpl/v0.5.2/OpenFrp-CrossPlatformLauncher_0.5.2_amd64.AppImage

步骤 2：赋予执行权限

与命令行版本一样，需要给 AppImage 文件添加执行权限。

1 2	# 替换为你的实际文件名 chmod +x OpenFrp-CrossPlatformLauncher_0.5.2_amd64.AppImage

步骤 3：运行程序

直接在终端中运行该文件

1 2	# 替换为你的实际文件名 ./OpenFrp-CrossPlatformLauncher_0.5.2_amd64.AppImage

程序启动后，会弹出一个图形界面。您只需在界面上填入您的用户密钥和隧道 ID，然后点击启动即可。

常见问题与排错 (Troubleshooting)

在安装和运行过程中遇到问题是正常现象。下面是一些常见问题的解决方法。

问题 1: Permission denied (权限不足)
- 现象: 执行 ./frpc_linux_amd64 时提示权限不足。
- 原因: 您忘记了为文件添加执行权限。
- 解决: 执行 chmod +x <你的文件名>。
问题 2: ./frpc_linux_amd64: No such file or directory (文件或目录不存在)
- 现象: 执行命令时提示找不到文件。
- 原因: 您当前所在的目录不包含该文件，或者文件名输错了。
- 解决: 使用 ls 命令查看当前目录下的文件，确保文件名正确无误。
问题 3: error while loading shared libraries: ... (缺少库文件)
- 现象: 运行程序时提示缺少某个 .so 库文件。
- 原因: 您的 Linux 系统缺少程序运行所必需的依赖库。这在非常精简的系统（如 Docker 容器或最小化安装的系统）中比较常见。
- 解决:
  1. 复制完整的错误信息。
  2. 将错误信息粘贴到您信任的搜索引擎（如 Google, Bing, Baidu）或 AI 助手（如 Kimi, Deepseek）中进行搜索。
  3. 搜索结果通常会告诉您缺少哪个软件包，并提供相应的安装命令（如 sudo apt-get install <package-name> 或 sudo yum install <package-name>）。

以上所有命令均在 Ubuntu 22.04 环境下测试通过。祝您使用愉快！

ZKY's Blog

OpenFRP Linux 安装使用教程