first build nexus

2026-03-23 20:57:45 +08:00
parent acb58c5684
commit e312026141
400 changed files with 52448 additions and 0 deletions
--- a/0.65.0（x86_64）操作笔记.md
+++ b/0.65.0（x86_64）操作笔记.md
@@ -0,0 +1,413 @@
+# Ubuntu 安装 FRP 0.65.0（x86_64）操作笔记
+
+```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)