OpenFrp Docs

# 常见应用

[TOC] 本篇为Github用户foxhank (opens new window)编写，感谢!!!

# 发布网站

提示

这篇文档只涉及 发布网站 的教程，您需要有一个 已经搭好、在内网可以访问 的网站才能进行穿透 常见的场景有发布博客或个人网站、外网访问路由器/NAS管理页面等。

注意：若穿透的是路由器管理等服务，请 一定设置一个强密码并更改默认用户名，建议 打开访问密码功能，以减少安全问题。

# 1. 获得本地 IP、端口和协议

首先用浏览器在内网访问一下服务，然后查看地址栏。访问时显示的网址多半是这样的:

无自定义端口：

http://<本地 IP>/	

有自定义端口：

http://<本地 IP>:<本地端口>/

比如：

# 本地 IP: 127.0.0.1,端口80
http://127.0.0.1/

# 本地 IP: 192.168.31.112，端口4000
http://192.168.31.112:4000/index.html

可以把这行网址分为四部分：

http://协议 192.168.31.112ip地址 :4000端口号

注：由于默认http端口号为80，所以当访问http://example.com 的时候，其实是在访问http://example.com:80。

# 2. 确定你需要的协议

我们提供三种 隧道类型 供您选择。您可以根据自身需求选择协议。

隧道类型 支持的协议 访问时带端口 使用自己的域名 举例
TCP http/https 必须 可选 http://xxx.openfrp.top:11451
HTTP http 不需 必须 http://example.com
example.com
HTTPS https 不需 必须 https://example.com
example.com

题外话：域名+端口的方式可能会不利于搜索引擎的收录。所以如果你想映射博客的话，建议选http（s），还方便记忆。

# 3. 选择穿透节点

在创建节点一页有各节点支持的协议、详细介绍等等。根据需要创建隧道。

这里以香港-5节点，http隧道，域名example.com，本地端口80为例。

创建隧道

填入所有标星号的信息，隧道类型选择http，点击提交，提示"创建成功"并自动跳转到“管理隧道”。

# 4. 域名解析

转到“配置文件”一栏，下拉框选择创建隧道的节点，会出现配置详情。复制下方的“server_addr"值，以便稍后使用。 配置详情

随后登录域名商的控制台。

由于各个注册商的用户界面差异较大，无法一一列举。如果实在是找不到可以上网搜索。

这里以阿里云为例。

进入控制台，搜索“域名”字样并进入。

控制台

随后点击“解析”进入解析管理

解析

选择“添加解析”，记录类型选择CNAME，主机记录填写@¹，记录值填写上文的“server_addr"值，随后确认即可。

添加解析

¹：可根据喜好选择域名前缀。比如

主机记录 实际网址
@ example.com
www www.example.com
(任何字母)如blog blog.example.com

注意：主机记录需与创建隧道时填写的域名一致：比如主机记录为@，则域名为example.com,那么上文创建隧道时填写的域名也应为example.com

等待域名解析生效即可用域名的形式连接。根据各服务商的不同，生效时间大概在10秒钟--10小时不等。

# 5. 启动隧道

启动隧道。若一切正常您就可以通过example.com的形式来访问网站。

启动隧道

# 常见问题

# 1.已经建好，但提示“503 Service Unavailable”

  1. 请检查创建隧道时，填写的域名是否与访问域名一致。

    请注意：www.example.com与 example.com是两个网站

    同样的，a.example.com与b.example.com也是两个网站

  2. 请检查FRP客户端是否有报错

    可能由于网络原因，导致客户端与服务器断开连接。一般稍等或手动重启隧道即可解决。

  3. 可能节点正在遭受攻击，请通过 状态监控 (opens new window)查看所选节点健康状态，或尝试更换节点。

  4. 域名解析到的节点是否和隧道所在的节点相同？

    请注意：DNS 解析修改后并不是立即生效的，解析结果缓存时长从 10 分钟到一星期不等，请等待解析生效后再试。

    Windows可通过以下命令查看dns解析地址

    nslookup <你的域名>

# 例如
nslookup www.example.com

    DNS查询

“名称”需为xx.openfrp.top才代表解析同步成功���

  1. 本地的 Web 服务是否成功启动？隧道映射的本地 IP 和端口号是否正确？
  • 是否能在 运行 frpc 的电脑 通过 本地 IP 和 本地端口 访问您的网站？
  • frpc 有没有显示 无法连接到本地服务 等错误？
  1. 客户端是否成功启动并出现 start proxy success 字样？
  • 在 Windows 上最好使用启动器管理隧道，Linux最好通过docker部署。
  1. (HTTPS 隧道)是否正确创建？访问的时候有没有输入完整的 https:// 前缀？
  • 只创建 HTTPS 隧道会导致使用 HTTP 协议访问时出现 503 错误

# 2. 提示“connection timed out“

可能是节点挂了，请等待或更换节点。

# 远程桌面

# Windows 远程桌面（RDP）

# 0. 安全提醒

映射远程桌面通常会带来出人意料的风险，因为巨硬的漏洞总是很多。

如果您需要映射远程桌面，我们强烈建议您启用 Windows Update 来避免批量 0day 漏洞利用使得您的电脑遭到攻击，并设置一个账户强密码。

虽然windows的系统更新安起来确实费劲,它可以帮助你免受病毒的侵袭。

# 0.1 设置账户密码

由于安全原因，windows不允许没有密码的账户进行远程连接。所以，被连接端需要设置一个账户密码。

# 0.1.1 Windows 7设置密码

点击头像

点击“开始”按钮，并点击右上角的头像，进入“用户账户”

创建密码

点击“为您的账户创建密码“

输入密码

输入两遍密码,点击"创建密码"，密码即设置成功

注意：密码提示不建议设置，若设置，请写一段只有你和用电脑的人知道的提示词，不要把密码放在密码提示中！

# 0.1.2 Windows 10设置密码

点击“开始”按钮，随后点击头像，点击“更改账户设置进入用户账户页面。

设置密码

选择“登录选项”，随后在密码一栏中点“添加”

输入两遍密码，即可创建。

# 1. 打开远程桌面功能

请注意：从Windows7开始，家庭版系统不支持远程桌面功能。您可以通过以下方式判断：

右键“我的电脑”，点击属性，查看右侧显示版本名称。

image-20230626112520494

若显示“家庭版”则无法使用。建议升级为专业版，或在网上寻找补丁打开远程桌面功能。使用补丁可能具有安全风险，请自行甄别

若您的电脑支持此功能，点击左侧的“远程设置”，随后界面点击"允许远程连接到此计算机"并点击确认

注意：远程协助和远程连接是两个不同的功能

image-20230626112917517

随后打开启动器，创建一个本地端口3389的隧道,并启动隧道。

image-20230626113758469

至此，被控端的配置便全部完成。

# 2.连接电脑

image-20230626114723795开始菜单-点开“windows附件”文件夹-打开“远程桌面连接”

image-20230626114841264

输入对方隧道网址，点击链接

若一切正常，接下来会让你输入用户密码，输入对方电脑的用户名和密码，点击确定

image-20230626115109232

由于电脑使用的是自签证书，会弹出安全提醒，点击“是”即可

image-20230626115244484

稍等片刻即可连接。此时已经可以使用了。

# 3. 可选：启用UDP连接

image-20230626115539253

这时你会发现，上面的信号栏只有两格信号，质量为良好。虽然也能用，但看着总归不舒服。

解决方法：image-20230626120252501

创建一个 相同远程端口，UDP模式的隧道。随后将两个隧道全开启。

image-20230626120440770

随后重启远程连接，可以发现提示“已启用UDP”，并且“良好”升级为“非常好

image-20230626121153826

# Linux 远程桌面（VNC）

不同于Windows自带的RDP，linux系统一般使用开源的VNC进行远程桌面连接。

演示环境：

被控端：Deepin 20.5，Linux内核5.1.101 OpenFRP V0.48.1 ,

# 1. 安装x11 VNC（若系统自带VNC可跳过）

sudo apt update
sudo apt install x11vnc -y

安装vnc

# 1.1 设置VNC密码(重要)

只要拥有域名和端口号的人都能通过vnc访问你的设备，所以设置一个密码十分重要

sudo x11vnc -storepasswd /etc/x11vnc.pass

设置一个一个一个密码

输入两遍密码，会提示你确认一遍路径，输y即可

# 1.2 配置开机自启

通过systemd控制服务开机自启

sudo vim /etc/systemd/system/x11vnc.service

随后按Insert进入输入模式，将配置复制进去后输入:wq保存并退出

[Unit]

Description=Start x11vnc at startup.

After=multi-user.target

[Service]

Type=simple

#ExecStart=/usr/bin/x11vnc -forever -rfbauth /etc/x11vnc.pass -rfbport 5900 -shared

ExecStart=/usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /etc/x11vnc.pass -rfbport 5900 -shared

[Install]

WantedBy=multi-user.target

随后systemctl三连击

开机自启systemctl enable x11vnc

启动服务systemctl start x11vnc

查看状态systemctl status x11vnc

启动服务

若输出中“Active”为“active（running）”则为启动成功，可以看到PORT=5900 ,意味着服务正运行在5900默认端口上。

# 2. 创建隧道

新建一个本地端口为5900的隧道，其余保持默认即可，点击提交

创建隧道

随后转到“隧道管理”，选择刚创建隧道的节点，将配置文件复制下来

配置文件

# 3. 安装及配置FRP服务

由于Linux版本的frpc没有控制面板，所以需自行配置frpc.ini文件。

先按照CPU架构下载Linux版本的FRPC客户端 (opens new window)，大部分是x86架构的系统，选择amd64即可。

下载后，将文件解压缩，重命名为frpc，并在同目录下创建一个名为frpc.ini的配置文件，如图所示

打开frpc.ini，将刚才复制的配置文件内容复制进去，保存并退出。

随后右键空白处，选择“在终端中打开“

输入命令启动隧道

nohup ./frpc -c ./frpc.ini &

会提示“忽略输入并把输出追加到”nohup.out“文件中，可通过

vi ./nohup.out

查看运行日志。若启动正常，会提示“隧道启动成功”，且提供一段网址，可通过此网址使用VNC客户端进行连接。

运行

# 群晖 NAS 远程管理

群晖虽然自带一个quickconnect远程管理服务，但黑群晖（盗版系统）用户是用不了的。况且由于群晖的服务器在台湾省，数据一来一回，延迟也高的要命。

演示环境：黑群晖 DSM 6.1.7 15284,，OpenFRP Docker端v0.48.0

# 1. 确认端口号

局域网进入群晖后台，进入“控制面板”，选择“网络”并切换到“DSM设置”栏，可以看到端口号，默认为5000（http）和5001（https）

端口号

# 2. 创建隧道

在控制台创建一个本地地址为172.17.0.1，本地端口为5000的TCP隧道

随后转到“隧道管理”，记下隧道的ID

image-20230628153524963再去“首页”复制下你的访问秘钥

image-20230628153716871

注意：请勿将访问秘钥告知任何人，OpenFRP官方不会索取您的访问秘钥，若在交流群里问问题，发送截图前请注意遮挡访问秘钥。若不慎泄露，可去个人中心-重置秘钥 进行秘钥重置

# 3. 使用docker安装OpenFRP

打开套件中心，左上角搜索栏输入“docker”，并点击安装套件。

安装

安装完成后点击打开。

由于Docker Hub在国内无法访问，所以选择“注册表”会提示“查询注册表失败”。

但可以使用docker pull命令下载镜像。

# 3.1 打开ssh功能

打开控制面板，拉到最下面选择“终端机和SNMP”，勾选“启用ssh功能”并应用。

启用ssh

随后Win+R，输入cmd，进入命令提示符，输入ssh （用户名）@（群晖ip）进行连接。

若提示'ssh' 不是内部或外部命令，也不是可运行的程序或批处理文件，说明你的电脑不自带ssh工具，请自行百度搜索“ssh连接群晖”安装工具并进行连接。此处不再赘述。

# 3.2 创建容器

输入

sudo docker run -d --name of openfrp/frpc:latest -u (你的访问秘钥) -p （你的隧道ID)

将用小括号括起来的字段换成你自己的内容。

比如：sudo docker run -d --name of openfrp/frpc:latest -u 1145141919810 -p 114514

若创建多个隧道，可输入

sudo docker run -d --name of openfrp/frpc:latest -u （你的访问秘钥） -p （你的隧道id）[,（隧道id2）,（隧道id3）]

比如 ： sudo docker run -d --name of openfrp/frpc:latest -u 1145141919810 -p 114514 [,114515 , 114516]

稍等一会，等显示一串字符就表示开启成功。

image-20230628155151092

# 4. 查看网址

输入

sudo docker logs of

查看容器日志。

使用提供的网址，即可进入群晖管理页。

# 5. 管理容器

群晖自带有一个可视化docker管理页面，不用每次都连接输命令。

网页控制台中，打开“docker”，选择“容器”找到名叫“of”的容器，即可方便控制开启或关闭

同时，您还可以双击进入容器，点击“日志”栏查看详细日志

# 远程唤醒

远程唤醒技术（WOL，Wake-on-LAN）是由网卡配合其他软硬件，通过给处于待机状态 (opens new window)的网卡发送特定的数据帧，实现电脑从停机状态启动的一种技术。

--摘自百度百科

简单地说，网络唤醒就像在家里局域网用大喇叭UDP广播喊电脑的名字MAC地址，就会把对应电脑叫醒。那么，要想在外面也能叫醒电脑，只要安一个远程喇叭就行了。

硬件方面需要网卡支持网络唤醒，不过现在百分之95的网卡都带这个功能，我一个09年的百兆垃圾网卡都支持这个功能

那么，理论成立，实践开始！

# 1. 创建内网穿透隧道

进入创建隧道栏，随便选一个节点，隧道名称随便填，本地端口选9，隧道类型选 UDP ， 本机地址填255.255.255.255 剩下的不用管，可以选“随机远程端口”或者输一个喜欢的数字，点提交

image-20230614202137433

创建完后会自动跳到隧道列表栏，记下隧道ID，等会要用

image-20230614201410965

# 2. 服务器端部署FRPC

我的NAS使用的是黑群晖DSM6.1.7版本，本质上是个魔改的Debian系统，所以可以用Linux的程序

为了方便调试，我使用docker运行，当然也可以使用其它方案，大同小异。

OpenFrp提供了一个官方的docker镜像，可以通过访问秘钥+隧道ID连接。

安装docker，打开SSH访问等步骤不再赘述，由于Docker Hub在国内无法正常访问，但能拉取镜像，所以这里采用ssh安装的方法

首先SSH连上要部署的服务器，输入

sudo docker run -d --name OpenFRP openfrp/frpc:latest -u （你的访问秘钥） -p （隧道ID）

比如：docker run -d --name OpenFRP openfrp/frpc:latest -u b7b***1c9 -p 1****0

安装速度取决于网速

image-20230614204200951

等一会后会显示一串字符，这就代表安装成功

# 3. 被控电脑打开远程开机功能

# 3.1 Windows

网络和Internet设置-更改适配器选项，各Windows版本不同，总之要进入网络连接控制里

image-20230614204837169

右键网卡，选择“属性”，依次选“配置”-“高级”-”魔术封包唤醒“，更改为“开启”

ps:如果你电脑的网卡找不到以上选项，就找那种包含“唤醒（wake up）”文字的属性，然后全部设置成开启就是

image-20230614205207917

随后切换到电源管理，把“允许此设备唤醒计算机”打开

控制面板设置

至此，系统部分配置完毕，接下来要进BIOS里调整了。

# 4.修改BIOS设置

由于各个品牌进入BIOS的方法不同，建议百度搜索“电脑品牌+BIOS”，有详细的方法，一般是开机狂按某个键或者按机箱/笔记本侧边的特定按钮。 进入BIOS后，按箭头键切换到“高级”一栏（或：电源管理），选择“PCI设置”，将‘Power On By PCIE/Onboard Lan’打开，（或者叫网络唤醒之类的名字） 将其切换为enable后 按F10保存并退出。 BIOS设置

# 5.发送唤醒包

# 5.1 Windows端

首先要下载一个wol的程序。不大，是个命令行程序，方便一键执行 WOLCMD网站 (opens new window) 下载 (opens new window) 下载是一个压缩包，打开后选择解压到C:\根目录里，方便调用命令行，或者可以修改成一个自己熟悉的文件夹，不过下面的命令就需要修改 解压缩 之后Windows+R组合键，输入CMD，打开命令行，输入

cd /d C:\ 
wolcmd （网卡MAC地址） （frp服务器地址）255.255.255.0 （隧道端口）

比如
wolcmd b8975a4d6e5b cn-hk-bgp-5.openfrp.top 255.255.255.0 11451 如果一切顺利，会提示“唤醒信号已发送至设备”，并显示frp服务器的ip地址和端口 发送成功

如果不清楚如何获取mac地址，可以看下面的5.1.1

# 5.1.1被唤醒电脑获取网卡MAC地址

Windows＋R组合键，输入CMD，打开命令行，输入命令

ipconfig /all

会输出一大堆东西，找到名字叫以太网（有线连接）或者叫无线网络适配器（wifi连接）的，这就是此网卡的MAC地址 MAC地址获取

# 5.1.2 通过bat批处理实现一键开机

新建一个文本文件，把上面的唤醒命令全部复制进去 bat文件内容 随后重命名文件，将后缀修改为.bat 修改后缀 修改完后就可以通过点击这个文件进行一键唤醒

# 5.2 安卓安装唤醒程序

可以去各大应用商店搜索关键词“Wake On LAN”，比如谷歌商店就有 或者下载这个安装包 https://cowtransfer.com/s/3a06bd6050a64c 提取码bjtym5

右下角+号-左上角手动输入 创建 输入你的信息即可，如图 输入信息 随后保存，返回到主页，点击条目即可发送唤醒信息

# 5.3 微信小程序唤醒

有很多支持网络唤醒的小程序，只要填入信息也可以做到远程唤醒。 具体可微信小程序搜索“网络唤醒”，都有详细的使用方法 小程序

# 常见问题：

1.无法唤醒？

  • 请留意电脑关机后，路由器端网卡指示灯是否还亮着，否则可能是网卡断电，需要去BIOS的电源管理里设置
  • 电脑最后一次关机是否为正常关机（点击关机键关机），意外断电无法使用wol唤醒
  • 台式电脑是否关闭过总电源？断电会造成存储的信息丢失，需要重新开机后关机才能使用

2.网卡设置中没有唤醒选项？ 可以尝试升级网卡驱动，部分非常非常古老的网卡可能没有这个功能，那也无能为力

# 更多...

欢迎各位大佬投稿，发布各种各样的应用教程！

您可以在Github上发布pull request (opens new window)，我们看到了会及时处理。