420 lines
5.8 KiB
Markdown
420 lines
5.8 KiB
Markdown
---
|
||
title: Ubuntu 安装 FRP 0.65.0（x86_64）操作笔记
|
||
author: shenwei
|
||
tags: [frp, frpc, ubuntu]
|
||
---
|
||
# Ubuntu 安装 FRP 0.65.0（x86_64）操作笔记
|
||
|
||
#ubuntu #frp #frpc
|
||
```table-of-contents
|
||
```
|
||
|
||
- **FRP版本**：0.65.0
|
||
- **CPU架构**：x86_64 (amd64)
|
||
- **安装路径**：`/opt/frp/frp_0.65.0_linux_amd64`
|
||
- **配置文件**：`frpc.toml`
|
||
- **服务管理**：systemd
|
||
|
||
此文档可以直接保存为 **README.md 或运维手册**。
|
||
|
||
---
|
||
|
||
## 一、环境信息
|
||
|
||
| 项目 | 内容 |
|
||
| ----- | ---------------------------------- |
|
||
| 系统 | Ubuntu Server 24.04 |
|
||
| 架构 | x86_64 (amd64) |
|
||
| 软件 | FRP 0.65.0 |
|
||
| 安装目录 | `/opt/frp/frp_0.65.0_linux_amd64` |
|
||
| 客户端程序 | `frpc` |
|
||
| 配置文件 | `frpc.toml` |
|
||
| 服务管理 | systemd |
|
||
|
||
---
|
||
|
||
## 二、创建安装目录
|
||
|
||
```bash
|
||
sudo mkdir -p /opt/frp
|
||
sudo chown -R $(whoami) /opt/frp
|
||
```
|
||
|
||
进入目录：
|
||
|
||
```bash
|
||
cd /opt/frp
|
||
```
|
||
|
||
---
|
||
|
||
## 三、下载 FRP
|
||
|
||
下载 **x86_64 版本**：
|
||
|
||
```bash
|
||
wget https://github.com/fatedier/frp/releases/download/v0.65.0/frp_0.65.0_linux_amd64.tar.gz
|
||
```
|
||
|
||
如果没有 wget：
|
||
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y wget
|
||
```
|
||
|
||
---
|
||
|
||
## 四、解压 FRP
|
||
|
||
```bash
|
||
tar -xzf frp_0.65.0_linux_amd64.tar.gz
|
||
```
|
||
|
||
解压后目录结构：
|
||
|
||
```
|
||
/opt/frp
|
||
└── frp_0.65.0_linux_amd64
|
||
├── frpc
|
||
├── frps
|
||
├── frpc.toml
|
||
├── frps.toml
|
||
└── LICENSE
|
||
```
|
||
|
||
进入目录：
|
||
|
||
```bash
|
||
cd /opt/frp/frp_0.65.0_linux_amd64
|
||
```
|
||
|
||
---
|
||
|
||
## 五、修改 frpc.toml 配置
|
||
|
||
编辑配置：
|
||
|
||
```bash
|
||
nano /opt/frp/frp_0.65.0_linux_amd64/frpc.toml
|
||
```
|
||
|
||
示例配置：
|
||
|
||
```toml
|
||
serverAddr = "192.227.222.142"
|
||
serverPort = 7000
|
||
|
||
[auth]
|
||
token = "your_token_here"
|
||
|
||
[[proxies]]
|
||
name = "ssh"
|
||
type = "tcp"
|
||
localIP = "127.0.0.1"
|
||
localPort = 22
|
||
remotePort = 6000
|
||
```
|
||
|
||
参数说明：
|
||
|
||
|参数|说明|
|
||
|---|---|
|
||
|serverAddr|frps服务器地址|
|
||
|serverPort|frps监听端口|
|
||
|auth.token|认证token|
|
||
|localIP|本地服务地址|
|
||
|localPort|本地端口|
|
||
|remotePort|frps映射端口|
|
||
|
||
---
|
||
|
||
## 六、测试运行
|
||
|
||
进入目录：
|
||
|
||
```bash
|
||
cd /opt/frp/frp_0.65.0_linux_amd64
|
||
```
|
||
|
||
启动客户端：
|
||
|
||
```bash
|
||
./frpc -c frpc.toml
|
||
```
|
||
|
||
成功日志示例：
|
||
|
||
```
|
||
login to server success
|
||
proxy added: ssh
|
||
start proxy success
|
||
```
|
||
|
||
按 `Ctrl + C` 停止测试。
|
||
|
||
---
|
||
|
||
## 七、systemd 服务管理（推荐）
|
||
|
||
### 1 创建 systemd 服务文件
|
||
|
||
```bash
|
||
sudo nano /etc/systemd/system/frpc.service
|
||
```
|
||
|
||
### 2 配置内容
|
||
|
||
```ini
|
||
[Unit]
|
||
Description=frp client
|
||
After=network-online.target
|
||
Wants=network-online.target
|
||
|
||
[Service]
|
||
Type=simple
|
||
ExecStart=/opt/frp/frp_0.65.0_linux_amd64/frpc -c /opt/frp/frp_0.65.0_linux_amd64/frpc.toml
|
||
Restart=on-failure
|
||
RestartSec=10
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
### 3 重新加载 systemd
|
||
|
||
```bash
|
||
sudo systemctl daemon-reload
|
||
```
|
||
|
||
### 4 启动 frpc 服务
|
||
|
||
```bash
|
||
sudo systemctl start frpc
|
||
```
|
||
|
||
### 5 设置开机自启
|
||
|
||
```bash
|
||
sudo systemctl enable frpc
|
||
```
|
||
|
||
### 6 查看服务状态
|
||
|
||
```bash
|
||
sudo systemctl status frpc
|
||
```
|
||
|
||
---
|
||
|
||
## 八、常用维护命令
|
||
|
||
### 查看 frpc 进程
|
||
|
||
```bash
|
||
ps aux | grep frpc
|
||
```
|
||
|
||
---
|
||
|
||
### 查看日志
|
||
|
||
```bash
|
||
sudo journalctl -u frpc -f
|
||
```
|
||
|
||
或查看历史日志：
|
||
|
||
```bash
|
||
sudo journalctl -u frpc --no-pager -n 50
|
||
```
|
||
|
||
---
|
||
|
||
### 重启 frpc
|
||
|
||
```bash
|
||
sudo systemctl restart frpc
|
||
```
|
||
|
||
---
|
||
|
||
### 停止 frpc
|
||
|
||
```bash
|
||
sudo systemctl stop frpc
|
||
```
|
||
|
||
---
|
||
|
||
### 禁用开机自启
|
||
|
||
```bash
|
||
sudo systemctl disable frpc
|
||
```
|
||
|
||
---
|
||
|
||
## 九、卸载 FRP
|
||
|
||
1. 停止服务：
|
||
|
||
```bash
|
||
sudo systemctl stop frpc
|
||
sudo systemctl disable frpc
|
||
```
|
||
|
||
2. 删除服务文件：
|
||
|
||
```bash
|
||
sudo rm /etc/systemd/system/frpc.service
|
||
sudo systemctl daemon-reload
|
||
```
|
||
|
||
3. 删除安装目录：
|
||
|
||
```bash
|
||
sudo rm -rf /opt/frp
|
||
```
|
||
|
||
---
|
||
|
||
## 十、升级 FRP
|
||
|
||
升级步骤：
|
||
|
||
```
|
||
停止 frpc
|
||
↓
|
||
下载新版本
|
||
↓
|
||
解压
|
||
↓
|
||
替换目录
|
||
↓
|
||
重新运行
|
||
```
|
||
|
||
示例：
|
||
|
||
```bash
|
||
sudo systemctl stop frpc
|
||
cd /opt/frp
|
||
wget https://github.com/fatedier/frp/releases/download/v0.66.0/frp_0.66.0_linux_amd64.tar.gz
|
||
tar -xzf frp_0.66.0_linux_amd64.tar.gz
|
||
# 如果需要可以更新软链接
|
||
sudo systemctl start frpc
|
||
```
|
||
|
||
---
|
||
|
||
## 十一、最终目录结构
|
||
|
||
```
|
||
/opt/frp
|
||
└── frp_0.65.0_linux_amd64
|
||
├── frpc
|
||
├── frps
|
||
├── frpc.toml
|
||
└── frps.toml
|
||
```
|
||
|
||
---
|
||
|
||
## 十二、生产环境最佳实践
|
||
|
||
### 1 统一路径
|
||
|
||
```
|
||
/opt/frp/<version>
|
||
```
|
||
|
||
方便版本切换。
|
||
|
||
例如：
|
||
|
||
```
|
||
/opt/frp/frp_0.65.0_linux_amd64
|
||
/opt/frp/frp_0.66.0_linux_amd64
|
||
```
|
||
|
||
---
|
||
|
||
### 2 创建软链接
|
||
|
||
```
|
||
/opt/frp/current
|
||
```
|
||
|
||
示例：
|
||
|
||
```bash
|
||
sudo ln -sfn /opt/frp/frp_0.65.0_linux_amd64 /opt/frp/current
|
||
```
|
||
|
||
启动时（修改 systemd 服务文件）：
|
||
|
||
```ini
|
||
ExecStart=/opt/frp/current/frpc -c /opt/frp/current/frpc.toml
|
||
```
|
||
|
||
升级时只需要切换 symlink，无需修改 systemd 配置。
|
||
|
||
---
|
||
|
||
### 3 日志管理
|
||
|
||
建议使用 journald 日志，可通过以下命令查看：
|
||
|
||
```bash
|
||
sudo journalctl -u frpc -f
|
||
```
|
||
|
||
---
|
||
|
||
## 十三、快速启动命令
|
||
|
||
日常手动运行（不通过 systemd）：
|
||
|
||
```bash
|
||
cd /opt/frp/frp_0.65.0_linux_amd64
|
||
./frpc -c frpc.toml
|
||
```
|
||
|
||
---
|
||
|
||
## 十四、故障排查
|
||
|
||
### 服务启动失败
|
||
|
||
1. 检查配置文件语法：
|
||
|
||
```bash
|
||
./frpc validate -c frpc.toml
|
||
```
|
||
|
||
2. 查看详细错误日志：
|
||
|
||
```bash
|
||
sudo journalctl -u frpc -e
|
||
```
|
||
|
||
3. 检查端口是否被占用：
|
||
|
||
```bash
|
||
sudo netstat -tlnp | grep <端口号>
|
||
```
|
||
|
||
### 无法连接 frps 服务器
|
||
|
||
1. 检查服务器地址和端口是否正确
|
||
2. 检查防火墙是否开放相应端口
|
||
3. 检查 token 是否匹配
|
||
|
||
---
|
||
|
||
## 十五、相关文档
|
||
|
||
- [Mac Mini 安装 FRP 0.65.0（ARM64）操作笔记](./🟣Mac%20Mini%20安装%20FRP%200.65.0（ARM64）操作笔记.md)
|
||
- [通过VPS+内网反向代理实现域名访问内网穿透](./通过VPS+内网反向代理实现域名访问内网穿透.md)
|