![Gemini_Generated_Image_dzaat3dzaat3dzaa.png](/static/img/c5f69f61efc3d977c81d495297317676.Gemini_Generated_Image_dzaat3dzaat3dzaa.webp)


# Windows下用frp穿透RDP：从踩坑到落地

作为远程办公党，“在外连回家中电脑”是刚需——而Windows自带的RDP（远程桌面）体验原生、功能完整，搭配frp内网穿透本是低成本方案首选。但实际操作中，我踩了一堆细节坑，折腾了大半天才跑通。这篇文章更新了2025年的最新细节，把完整过程、避坑指南和工具资源都理清楚，帮你少走弯路。


## 一、准备工作：工具清单与下载地址
要实现frp穿透RDP，需要**公网服务器（frp服务端）** + **本地Windows电脑（frp客户端）**，先把工具备好（注意新版frp的配置文件变化）：

| 工具       | 作用                     | 项目地址 & 下载方式                                                                 |
|------------|--------------------------|-------------------------------------------------------------------------------------|
| frp（最新版） | 实现内网穿透的核心工具   | - GitHub项目：https://github.com/fatedier/frp<br>- 下载页：https://github.com/fatedier/frp/releases<br>（选对应系统版本：Windows客户端选`frp_xxx_windows_amd64.zip`，Linux服务端选`frp_xxx_linux_amd64.tar.gz`） |
| 公网服务器 | 部署frp服务端（转发流量） | 可选择云服务器（如阿里云/腾讯云轻量应用服务器），系统选Linux（CentOS/Ubuntu均可）    |
| （可选）RustDesk | 家庭版替代远程工具       | - GitHub项目：https://github.com/rustdesk/rustdesk<br>- 官网下载：https://rustdesk.com/ |


## 二、实操过程：2025版frp穿透RDP的完整步骤
### 1. 部署frp服务端（公网服务器）
先在公网服务器上配置服务端：
- 下载对应Linux版本的frp，解压后编辑`frps.ini`（注意后缀）：
  ```ini
  [common]
  bind_port = 7000  # frp主通信端口（需在服务器防火墙开放）
  token = "123456"  # 客户端连接的密钥（自定义，需和客户端一致）
  ```
- 启动服务端：
  ```bash
  ./frps -c frps.ini
  ```
  （若需后台运行，可搭配`nohup`：`nohup ./frps -c frps.ini &`）


### 2. 配置frp客户端（本地Windows电脑）
- 解压Windows版frp到本地（如`C:\Users\zjjzxs2\Desktop\frp_0.65.0_windows_amd64`）；
- 手动修改`frpc.toml`文件，填写配置：
  ```toml
  [common]
  server_addr = "你的公网服务器IP"  # 如123.45.67.89
  server_port = 7000             # 和服务端bind_port一致
  token = "123456"               # 和服务端token一致

  [[proxies]]
  name = "rdp"
  type = "tcp"                   # RDP是TCP协议
  local_ip = "127.0.0.1"         # 本地回环地址
  local_port = 3389              # RDP默认端口
  remote_port = 7001             # 公网暴露的端口（需在服务器防火墙开放）
  ```


### 3. 启动frp客户端（Windows cmd命令）
新版frp客户端双击`frpc.exe`会弹出提示窗口，明确告知“需通过命令行指定配置文件启动”，正确操作步骤：
1. 按下`Win+R`，输入`cmd`打开命令提示符；
2. 切换到frp解压目录（替换为你的实际路径）：
   ```cmd
   cd C:\Users\zjjzxs2\Desktop\frp_0.65.0_windows_amd64
   ```
3. 加载toml配置文件启动客户端：
   ```cmd
   frpc.exe -c frpc.toml
   ```
   （若需后台运行，可加`start /b`：`start /b frpc.exe -c frpc.toml`）


## 三、踩坑实录
看似简单的步骤，实际踩了一堆坑：


### Windows家庭版不支持RDP
- **现象**：启动frpc后，远程桌面连接提示“无法连接”，测试本地3389端口不通；
- **原因**：Windows 10家庭版**默认不支持内置RDP服务**，仅专业版/企业版才有；
- **解决**：
  - 合法方案：升级到专业版（下文有指南）；
  - 替代方案：用RustDesk等第三方远程工具。


### 混淆“账户全名”和“系统用户名”
- **现象**：解决版本问题后远程登录时，输入“zym”（账户全名）提示“用户不存在”；
- **原因**：
  - `zjjzxs2`是**系统用户名**（系统识别的唯一标识）；
  - `zym`是**账户全名**（仅界面显示用）；
- **解决**：所有系统操作（如`runas`）需用系统用户名（如`zjjzxs2`）。


![PixPin_2025-11-28_22-17-39.png](/static/img/42acee726135f82d9b515c42a665b2a6.PixPin_2025-11-28_22-17-39.webp)


## 四、效果评价：frp穿透RDP到底适合做什么？
在解决所有坑（尤其是Windows升级到专业版+服务器带宽足够）后，frp穿透RDP的体验是“轻量场景够用，重度场景拉胯”：
- **能做的事**：
  - 浏览网页、查看本地文件、简单文档编辑；
  - 远程管理本地电脑的基础设置。
- **不能做的事**：
  - 看视频（画面卡顿、音画不同步）；
  - 运行专业软件（如PS、编程IDE，操作延迟会影响效率）；
- **核心瓶颈**：受限于公网服务器的带宽和网络延迟，原生RDP的高画质传输需求很难满足。


## 附录、Windows 10家庭版升级专业版指南
家庭版无法用RDP，升级到专业版是根本解决方法，分两种方式：

### 1. 官方合法方式（推荐）
- 步骤：打开「设置」→「更新和安全」→「激活」→「更改产品密钥」，输入**正版Windows 10专业版激活码**；
- 效果：系统自动下载专业版组件，重启后即可启用RDP，数据不丢失；
- 注意：激活码需从微软官方/授权经销商购买。


### 2. 非官方方式（风险）
- 工具：heukms等KMS激活工具；
- 风险：违反微软EULA协议、工具可能携带恶意程序、Windows更新后激活失效，**不推荐使用**。


## 替代方案：家庭版用户的折中选择
若不想升级系统，用第三方远程工具更省心，推荐这两个：

| 工具       | 优势                     | 下载地址                     |
|------------|--------------------------|------------------------------|
| RustDesk   | 开源免费、跨平台、无需穿透 | https://rustdesk.com/        |
| 网易UU远程 | 游戏级低延迟、不限速传输  | https://uu.163.com/          |


## 结语
frp穿透RDP是“技术向用户”的低成本方案，但只适合轻量远程需求；若你是Windows家庭版用户，直接用RustDesk或者更加成熟的p2p方案会更高效。

最后提醒：内网穿透涉及公网暴露端口，务必设置强密码、限制IP访问，避免安全风险~

Windows下用frp穿透RDP

![Gemini_Generated_Image_9gbeps9gbeps9gbe.png](/static/img/95d77769e72e21519dbdecfa80d8cf21.Gemini_Generated_Image_9gbeps9gbeps9gbe.webp)




# Step 1：开启飞牛系统 SSH 功能



1. 登录飞牛系统，点击 **系统设置**。

2. 找到 **SSH 功能**，默认端口是 22（可根据需要调整）。

3. 将 SSH 功能的开关打开，准备好远程连接。


![PixPin_2025-11-23_16-50-53.png](/static/img/bc06f087b888b487a4c068ab54cdcbf9.PixPin_2025-11-23_16-50-53.webp)

# Step 2：通过命令行连接飞牛 NAS



1. 在另一台电脑（Windows 或 Mac）上进行操作：

* **Windows 用户**：打开开始菜单，输入 "CMD"，以管理员身份运行命令提示符。

* **Mac 用户**：直接打开终端。

![PixPin_2025-11-23_16-51-17.png](/static/img/dda6c6a8bee8b479ae0d866b37402329.PixPin_2025-11-23_16-51-17.webp)

1. 输入以下命令连接飞牛 NAS：




```
ssh 用户名@IP地址
```

例如，我的用户名是 hongtoufa666，IP 地址是 192.168.1.88，命令为：



```
ssh hongtoufa666@192.168.1.88
```

回车后，系统会提示输入密码。由于安全机制，输入密码时屏幕不会显示，直接输入并按回车即可。

**Tips：** 除了命令行，你也可以用 Putty 或 XShell 等 SSH 工具连接，但命令行操作更简单直接！

# Step 3：编辑配置文件，禁用休眠



1. 连接成功后，输入以下命令打开配置文件：



```
sudo vim /etc/systemd/logind.conf
```

（具体路径请参考飞牛系统文档，Vim 和 Vi 命令均可使用）

回车后，系统可能再次要求输入飞牛账号密码，输入后进入 Vim 编辑器。



1. 在 Vim 中，使用键盘的上下左右键移动光标，找到以下两项配置：

   **第一项**：找到类似`#HandleLidSwitch=suspend`的配置。

   **第二项**：找到类似`#LidSwitchIgnoreInhibited`

* 按下`i`键进入编辑模式（屏幕会出现 "insert" 标识）。

* 删除前面的 #号（取消注释），将 suspend 改为 ignore。

* 同样删除 #号，取消注释，使配置生效。`LidSwitchIgnoreInhibited=yes`

1. 编辑完成后，按`Esc`退出编辑模式，然后输入`shift + :`，接着输入`wq`并回车，保存并退出文件。

**Tips：** 如果你熟悉 Linux 操作，这个步骤分分钟搞定！不熟悉也没关系，严格按照步骤来，保证零失误！

# Step 4：重启系统，验证效果

输入以下命令重启飞牛 NAS：



```
sudo reboot
```

系统重启后，合上笔记本盖子，测试效果：



* 检查远程连接是否中断。

* 登录飞牛系统，打开应用中心，确认是否可以正常操作。

经过测试，合盖后 NAS 依然正常运行，远程连接不中断，完美解决休眠问题！



***


**参考链接：**



* [飞牛系统](https://zhida.zhihu.com/search?content_id=260185696\&content_type=Article\&match_order=1\&q=%E9%A3%9E%E7%89%9B%E7%B3%BB%E7%BB%9F\&zd_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ6aGlkYV9zZXJ2ZXIiLCJleHAiOjE3NjQwNjAzMjYsInEiOiLpo57niZvns7vnu58iLCJ6aGlkYV9zb3VyY2UiOiJlbnRpdHkiLCJjb250ZW50X2lkIjoyNjAxODU2OTYsImNvbnRlbnRfdHlwZSI6IkFydGljbGUiLCJtYXRjaF9vcmRlciI6MSwiemRfdG9rZW4iOm51bGx9.QZOU6RbBjtAld5DN3y7890GI-kS0VBnAn6Sa9PtM4mc\&zhida_source=entity)

* [SSH 功能](https://zhida.zhihu.com/search?content_id=260185696\&content_type=Article\&match_order=1\&q=SSH%E5%8A%9F%E8%83%BD\&zd_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ6aGlkYV9zZXJ2ZXIiLCJleHAiOjE3NjQwNjAzMjYsInEiOiJTU0jlip_og70iLCJ6aGlkYV9zb3VyY2UiOiJlbnRpdHkiLCJjb250ZW50X2lkIjoyNjAxODU2OTYsImNvbnRlbnRfdHlwZSI6IkFydGljbGUiLCJtYXRjaF9vcmRlciI6MSwiemRfdG9rZW4iOm51bGx9.kZuMKyUY8s4ZOhHf67h2unTjlZeV1kPngocaBmtki24\&zhida_source=entity)

* [Vim 编辑器](https://zhida.zhihu.com/search?content_id=260185696\&content_type=Article\&match_order=1\&q=Vim%E7%BC%96%E8%BE%91%E5%99%A8\&zd_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ6aGlkYV9zZXJ2ZXIiLCJleHAiOjE3NjQwNjAzMjYsInEiOiJWaW3nvJbovpHlmagiLCJ6aGlkYV9zb3VyY2UiOiJlbnRpdHkiLCJjb250ZW50X2lkIjoyNjAxODU2OTYsImNvbnRlbnRfdHlwZSI6IkFydGljbGUiLCJtYXRjaF9vcmRlciI6MSwiemRfdG9rZW4iOm51bGx9.eCI48nMLQzcUsZLDxKNeF8c0pqDPYS2kl9toG0zc-fQ\&zhida_source=entity)

* [LidSwitchIgnoreInhibited](https://zhida.zhihu.com/search?content_id=260185696\&content_type=Article\&match_order=1\&q=LidSwitchIgnoreInhibited\&zd_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ6aGlkYV9zZXJ2ZXIiLCJleHAiOjE3NjQwNjAzMjYsInEiOiJMaWRTd2l0Y2hJZ25vcmVJbmhpYml0ZWQiLCJ6aGlkYV9zb3VyY2UiOiJlbnRpdHkiLCJjb250ZW50X2lkIjoyNjAxODU2OTYsImNvbnRlbnRfdHlwZSI6IkFydGljbGUiLCJtYXRjaF9vcmRlciI6MSwiemRfdG9rZW4iOm51bGx9.11mZYvzPVzYpx5UKz7_vbwP_hxYhbktgRY8pxZNVUPk\&zhida_source=entity)

> （注：文档部分内容可能由 AI 生成）

旧笔记本安装飞牛设置合盖不休眠

![Gemini_Generated_Image_7fhfij7fhfij7fhf.png](/static/img/b806bf8e423ec7a475b4d9f4e26b3d7e.Gemini_Generated_Image_7fhfij7fhfij7fhf.webp)



![Gemini_Generated_Image_z94sdrz94sdrz94s.png](/static/img/f5412120ae12ba932850578af1a7498b.Gemini_Generated_Image_z94sdrz94sdrz94s.webp)

复制url地址为什么会变成标题文字

![Gemini_Generated_Image_1v7tfd1v7tfd1v7t.png](/static/img/40db6f8b5edd0790930793f99dfb2353.Gemini_Generated_Image_1v7tfd1v7tfd1v7t.webp)




如果你正在使用个人NAS，并且希望通过 **Nextcloud AIO (All-in-One)** 获得最完整、最稳定的私人云体验（包括高性能文件管理、日历、通讯录等），那么，这篇文章就是为你准备的。


## **核心架构图**

我们将采用以下架构，在本地部署nextcloud：

1. **本地 (极空间):** 运行 Nextcloud AIO（配置为**反向代理模式**，仅监听本地端口）。  
2. **本地 (极空间):** 运行 FRP 客户端 (frpc)，将 AIO 的端口加密穿透到云端。  
3. **云端 (VPS):** 运行 FRP 服务端 (frps) 和 Nginx Proxy Manager (NPM)。  
4. **云端 (VPS):** NPM 负责处理 SSL 证书和公网访问，将流量转发给 FRP。

## **第一步：准备工作 (清理环境)**

如果你之前尝试安装过 AIO 但失败了，必须先进行彻底清理，否则新配置不会生效。

1. 停止并删除容器：  
   在极空间 SSH 或 Docker 管理器中，停止所有 nextcloud-aio-\* 开头的容器。  
   docker compose down

2. 关键：删除配置卷 (必须做！)  
   AIO 的配置文件存储在 Docker 卷中，必须删除它才能让新的环境变量生效。  
   docker volume rm nextcloud\_aio\_mastercontainer

   *(注意：这只会重置 AIO 的安装向导配置，不会删除你的 NEXTCLOUD\_DATADIR 里的用户文件)*

## **第二步：部署 AIO (反向代理模式)**

这是最关键的一步。我们要通过特殊的配置，告诉 AIO 不要自己管理 SSL，而是把 HTTP 服务暴露出来给我们的代理用。

创建一个新的 docker-compose.yml 文件：


```js
services:  
  nextcloud-aio-mastercontainer:  
    image: ghcr.io/nextcloud-releases/all-in-one:latest  
    init: true  
    restart: always  
    container\_name: nextcloud-aio-mastercontainer  
    privileged: true  \# 推荐加上，赋予更高权限以减少网络问题  
    volumes:  
      \- nextcloud\_aio\_mastercontainer:/mnt/docker-aio-config  
      \- /var/run/docker.sock:/var/run/docker.sock:ro  
    ports:  
      \# AIO 管理界面端口 (仅本地访问)  
      \- 8082:8080  
    environment:  
      \# \--- 核心配置：开启反向代理模式 \---  
      \# 告诉 AIO 在 11000 端口提供未加密的 HTTP 服务  
      \- APACHE\_PORT=11000  
      \# 关键：绑定到 127.0.0.1，防止局域网直接未加密访问，只允许本机 FRP 抓取  
      \- APACHE\_IP\_BINDING=127.0.0.1  
        
      \# \--- 数据目录配置 (根据你的实际情况修改) \---  
      \# MOUNT 是父目录，DATADIR 是子目录  
      \- NEXTCLOUD\_MOUNT=/mnt/  
      \- NEXTCLOUD\_DATADIR=/mnt/nextcloud\_data

      \# \--- 首次启动自动安装的应用 \---  
      \- NEXTCLOUD\_STARTUP\_APPS=deck twofactor\_totp tasks calendar contacts notes

volumes:  
  nextcloud\_aio\_mastercontainer:  
    name: nextcloud\_aio\_mastercontainer

```
**启动命令：**

`docker compose up \-d`

:::note{title="docker-compose完整版"}

```js
services:
  nextcloud-aio-mastercontainer:
    image: ghcr.io/nextcloud-releases/all-in-one:latest # 这是使用的容器镜像。如果你想帮助测试新版本，可以切换到 ghcr.io/nextcloud-releases/all-in-one:beta。详见 https://github.com/nextcloud/all-in-one#how-to-switch-the-channel
    init: true # 此设置确保容器内主进程的信号能正确转发给子进程。详见 https://docs.docker.com/reference/compose-file/services/#init
    restart: always # 这能确保容器总是随着宿主机操作系统一起启动。详见 https://docs.docker.com/reference/compose-file/services/#restart
    container_name: nextcloud-aio-mastercontainer # 这一行不允许更改，否则 AIO 将无法正常工作
    volumes:
      - nextcloud_aio_mastercontainer:/mnt/docker-aio-config # 这一行不允许更改，否则内置的备份解决方案将无法工作
      - /var/run/docker.sock:/var/run/docker.sock:ro # 在 macOS, Windows 或 docker rootless 模式下可能需要更改。请参阅相关文档。如果调整了此项，别忘了也设置 'WATCHTOWER_DOCKER_SOCKET_PATH'！
    network_mode: bridge # 这会将容器添加到 docker run 默认会使用的网络中。如果你想为 docker 网络定义自定义 MTU 大小，请注释掉此行，并取消注释下面一行的 'networks' 以及文件末尾的 networks 部分
    # networks: ["nextcloud-aio"]
    ports:
      - 80:80 # 当在 Web 服务器或反向代理（如 Apache, Nginx, Caddy, Cloudflare Tunnel 等）后运行时可以移除。详见 https://github.com/nextcloud/all-in-one/blob/main/reverse-proxy.md
      - 8080:8080 # 这是 AIO 的管理界面，通过 https 和自签名证书提供服务。详见 https://github.com/nextcloud/all-in-one#explanation-of-used-ports
      - 8443:8443 # 当在 Web 服务器或反向代理（如 Apache, Nginx, Caddy, Cloudflare Tunnel 等）后运行时可以移除。详见 https://github.com/nextcloud/all-in-one/blob/main/reverse-proxy.md
    # security_opt: ["label:disable"] # 在使用 SELinux 时需要此项。详见 https://github.com/nextcloud/all-in-one#are-there-known-problems-when-selinux-is-enabled
    # environment: # 当使用以下任何选项时需要
    #   # AIO_DISABLE_BACKUP_SECTION: false # 设置为 true 可以在 AIO 界面中隐藏备份部分。详见 https://github.com/nextcloud/all-in-one#how-to-disable-the-backup-section
    #   # APACHE_PORT: 11000 # 当在 Web 服务器或反向代理（如 Apache, Nginx, Caddy, Cloudflare Tunnel 等）后运行时需要。详见 https://github.com/nextcloud/all-in-one/blob/main/reverse-proxy.md
    #   # APACHE_IP_BINDING: 127.0.0.1 # 当在同一主机上运行的 Web 服务器或反向代理（如 Apache, Nginx, Caddy, Cloudflare Tunnel 等）后运行时应设置此项。详见 https://github.com/nextcloud/all-in-one/blob/main/reverse-proxy.md
    #   # APACHE_ADDITIONAL_NETWORK: frontend_net # (可选) 将 Apache 容器连接到一个额外的 docker 网络。当反向代理在同一台服务器的不同 docker 网络中运行时需要。详见 https://github.com/nextcloud/all-in-one/blob/main/reverse-proxy.md
    #   # BORG_RETENTION_POLICY: --keep-within=7d --keep-weekly=4 --keep-monthly=6 # 允许调整 Borg 的备份保留策略。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-borgs-retention-policy
    #   # COLLABORA_SECCOMP_DISABLED: false # 设置为 true 允许禁用 Collabora 的 Seccomp 功能。详见 https://github.com/nextcloud/all-in-one#how-to-disable-collaboras-seccomp-feature
    #   # FULLTEXTSEARCH_JAVA_OPTIONS: "-Xms1024M -Xmx1024M" # 允许调整全文搜索的 java 选项。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-the-fulltextsearch-java-options
    #   # NEXTCLOUD_DATADIR: /mnt/ncdata # 允许设置 Nextcloud 数据目录的宿主机路径。⚠️⚠️⚠️ 警告：在 Nextcloud 首次安装完成后，不要设置或调整此值！详见 https://github.com/nextcloud/all-in-one#how-to-change-the-default-location-of-nextclouds-datadir
    #   # NEXTCLOUD_MOUNT: /mnt/ # 允许 Nextcloud 容器访问宿主机上的所选目录。详见 https://github.com/nextcloud/all-in-one#how-to-allow-the-nextcloud-container-to-access-directories-on-the-host
    #   # NEXTCLOUD_UPLOAD_LIMIT: 16G # 如果你需要更大的值，可以调整。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-the-upload-limit-for-nextcloud
    #   # NEXTCLOUD_MAX_TIME: 3600 # 如果你需要更长的时间，可以调整。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-the-max-execution-time-for-nextcloud
    #   # NEXTCLOUD_MEMORY_LIMIT: 512M # 如果你需要更多内存，可以调整。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-the-php-memory-limit-for-nextcloud
    #   # NEXTCLOUD_TRUSTED_CACERTS_DIR: /path/to/my/cacerts # 此目录中的 CA 证书将被 Nextcloud 容器的操作系统信任 (例如，对 LDAPS 很有用)。详见 https://github.com/nextcloud/all-in-one#how-to-trust-user-defined-certification-authorities-ca
    #   # NEXTCLOUD_STARTUP_APPS: deck twofactor_totp tasks calendar contacts notes # 允许修改首次启动 AIO 时安装的 Nextcloud 应用。详见 https://github.com/nextcloud/all-in-one#how-to-change-the-nextcloud-apps-that-are-installed-on-the-first-startup
    #   # NEXTCLOUD_ADDITIONAL_APKS: imagemagick # 允许向 Nextcloud 容器永久添加额外的软件包。默认为 imagemagick，但可以通过修改此值来覆盖。详见 https://github.com/nextcloud/all-in-one#how-to-add-os-packages-permanently-to-the-nextcloud-container
    #   # NEXTCLOUD_ADDITIONAL_PHP_EXTENSIONS: imagick # 允许向 Nextcloud 容器永久添加额外的 PHP 扩展。默认为 imagick，但可以通过修改此值来覆盖。详见 https://github.com/nextcloud/all-in-one#how-to-add-php-extensions-permanently-to-the-nextcloud-container
    #   # NEXTCLOUD_ENABLE_DRI_DEVICE: true # 允许为能从中受益的容器启用 /dev/dri 设备。⚠️⚠️⚠️ 警告：这仅在宿主机上存在 '/dev/dri' 设备时才有效！如果你的宿主机上没有它，请不要将此值设置为 true，否则 Nextcloud 容器将启动失败！详见 https://github.com/nextcloud/all-in-one#how-to-enable-hardware-acceleration-for-nextcloud
    #   # NEXTCLOUD_ENABLE_NVIDIA_GPU: true # 允许为能从中受益的容器启用 NVIDIA 运行时和 GPU 访问。⚠️⚠️⚠️ 警告：这仅在服务器上安装了 NVIDIA GPU 时才有效。详见 https://github.com/nextcloud/all-in-one#how-to-enable-hardware-acceleration-for-nextcloud
    #   # NEXTCLOUD_KEEP_DISABLED_APPS: false # 设置为 true 将保留在 AIO 界面中被禁用的 Nextcloud 应用，并且在它们已安装的情况下不会卸载它们。详见 https://github.com/nextcloud/all-in-one#how-to-keep-disabled-apps
    #   # SKIP_DOMAIN_VALIDATION: false # 仅在所有配置都正确的情况下才应设置为 true。详见 https://github.com/nextcloud/all-in-one?tab=readme-ov-file#how-to-skip-the-domain-validation
    #   # TALK_PORT: 3478 # 允许调整 Talk 容器在宿主机上暴露的端口。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-the-talk-port
    #   # WATCHTOWER_DOCKER_SOCKET_PATH: /var/run/docker.sock # 当宿主机上的 docker socket 不在默认的 '/var/run/docker.sock' 位置时需要指定。否则 mastercontainer 更新将失败。对于 macos，它需要是 '/var/run/docker.sock'

#   # 可选：Caddy 反向代理。详见 https://github.com/nextcloud/all-in-one/discussions/575
#   # 或者，如果你还没有域名，可以使用 Tailscale。详见 https://github.com/nextcloud/all-in-one/discussions/6817
#   # 提示：你需要取消注释上面的 APACHE_PORT: 11000，将 cloud.example.com 调整为你的域名，并取消注释此文件底部必要的 docker volumes 才能使其工作
#   # 你可以在这里找到更多示例：https://github.com/nextcloud/all-in-one/discussions/588
#   caddy:
#     image: caddy:alpine
#     restart: always
#     container_name: caddy
#     volumes:
#       - caddy_certs:/certs
#       - caddy_config:/config
#       - caddy_data:/data
#       - caddy_sites:/srv
#     network_mode: "host"
#     configs:
#       - source: Caddyfile
#         target: /etc/caddy/Caddyfile
# configs:
#   Caddyfile:
#     content: |
#       # 下面将 cloud.example.com 调整为你的域名
#       https://cloud.example.com:443 {
#         reverse_proxy localhost:11000
#       }

volumes: # 如果你想将数据存储在不同的驱动器上，请参阅 https://github.com/nextcloud/all-in-one#how-to-store-the-filesinstallation-on-a-separate-drive
  nextcloud_aio_mastercontainer:
    name: nextcloud_aio_mastercontainer # 这一行不允许更改，否则内置的备份解决方案将无法工作
  # caddy_certs:
  # caddy_config:
  # caddy_data:
  # caddy_sites:

# # 调整 docker 网络的 MTU 大小。详见 https://github.com/nextcloud/all-in-one#how-to-adjust-the-mtu-size-of-the-docker-network
# networks:
#   nextcloud-aio:
#     name: nextcloud-aio
#     driver_opts:
#       com.docker.network.driver.mtu: 1440
```
:::

## **第三步：配置 FRP (内网穿透)**

我们需要把极空间本地的 127.0.0.1:11000 (Nextcloud) 和 127.0.0.1:8082 (AIO 管理后台，可选) 穿透出去。

**本地 frpc.ini 配置参考：**



```js
\[common\]  
server\_addr \= \<你的云服务器IP\>  
server\_port \= 7000  
\# ... 其他配置 ...

\# 转发 Nextcloud 主程序  
\[nextcloud-http\]  
type \= tcp  
local\_ip \= 127.0.0.1  
local\_port \= 11000  
remote\_port \= 11000  \# 云服务器上对应的端口

\# (可选) 转发 AIO 管理后台，仅在需要维护时开启  
\[nextcloud-aio-admin\]  
type \= tcp  
local\_ip \= 127.0.0.1  
local\_port \= 8082  
remote\_port \= 8082
```
## **第四步：配置 Nginx Proxy Manager (云端)**

登录你云服务器上的 NPM 管理后台，添加一个新的 **Proxy Host**：

1. **Domain Names:** 你的域名 (如 cloud.zym588.space)  
2. **Scheme:** http (注意是 http，因为 FRP 转发出来的是未加密的流量)  
3. **Forward Hostname / IP:** 127.0.0.1 (因为 frps 就在这台云服务器上)  
4. **Forward Port:** 11000 (对应 frpc 里的 remote\_port)  
5. **Websockets Support:** **开启** (Nextcloud 需要)  
6. **SSL:** 申请并开启 Let's Encrypt 证书，勾选 Force SSL 和 HTTP/2 Support。

## **第五步：初始化安装**

1. 访问 AIO 管理后台：  
   在浏览器打开 `https://\<你的局域网IP\>:8082` (或者通过 FRP 的`https://\<域名\>:8082`)。  
   注意：必须使用 HTTPS 访问，接受自签名证书警告。  
2. 输入域名：  
   在 "New AIO instance" 页面，输入你的公网域名 `cloud.zym588.space`。  
    **原理：** 因为我们配置了 APACHE\_PORT，AIO 会自动识别为“反向代理模式”，并**跳过**复杂的域名验证步骤。  
3. 启动容器：  
   选择时区 (Asia/Shanghai)，不勾选 "Install Nextcloud Hub 25" (以安装最新版)，然后点击 "Download and start containers"。  
4. 耐心等待：  
   这将花费 5-20 分钟。你可以刷新页面查看进度。  
5. 获取密码：  
   当所有容器变绿后，AIO 页面会显示初始的 admin 账号和密码。务必保存！

## **第六步：解决“应用商店空白”问题 (配置代理)**

由于 AIO 容器在极空间网络环境下无法直接访问外网（Docker Hub 或 Nextcloud 应用商店），你需要为它配置代理。

**注意：AIO 界面没有提供代理设置框，我们必须修改配置文件。**

1. **进入 SSH 终端**，连接到极空间。  
2. 使用临时容器修改配置：  
   运行以下命令，用 vi 编辑 Nextcloud 的 config.php：  
   `docker run \-it \--rm \--volume nextcloud\_aio\_nextcloud:/var/www/html:rw alpine sh \-c "vi /var/www/html/config/config.php"
`
3. 添加代理代码：  
   在文件末尾的 ); 之前，插入以下代码（替换为你自己的代理地址）：  

```js
     'proxy' \=\> 'http://\<代理账号\>:\<代理密码\>@\<代理IP\>:\<端口\>',  
     'proxyexclude' \=\>   
     array (  
       0 \=\> 'localhost',  
       1 \=\> '127.0.0.1',  
       2 \=\> 'nextcloud-aio-database',  
       3 \=\> 'nextcloud-aio-redis',  
       4 \=\> 'nextcloud-aio-apache',  
       5 \=\> 'nextcloud-aio-mastercontainer',  
       6 \=\> '你的域名 (cloud.zym588.space)',  
       7 \=\> '你的极空间内网IP (192.168.31.221)',  
     ),  

```

nextcloud部署全流程

![Gemini_Generated_Image_m7kbd6m7kbd6m7kb.png](/static/img/8cf4bbe4d0014eaca3eb13ba5d7215b0.Gemini_Generated_Image_m7kbd6m7kbd6m7kb.webp)

虽然现在博客内容还很少，但万一坚持下去以后内容变多了呢，所以提前部署一个智能问答机器人，这样可以通过提问查询本地知识库的方式快速获取自己以前记录的一些内容。



# 一、部署智能体平台
MaxKB = Max Knowledge Brain，是一个强大易用的企业级智能体平台，支持快速接入主流大模型，高效构建专属知识库，并提供从基础问答（RAG）、复杂流程自动化（工作流）到智能体（Agent）的渐进式升级路径，全面赋能智能客服、智能办公助手等多种应用场景。

项目地址：https://github.com/1Panel-dev/MaxKB

这里只讨论linux，最简单的方法，请执行下面的脚本，使用 Docker 启动 MaxKB 容器：

`docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb`

如果网络环境不允许，也可以采用离线安装:https://maxkb.cn/docs/v2/installation/offline_installtion/

安装运行后，访问云服务器IP：8080即可访问到maxkb的管理后台。

默认登录信息
用户名：admin
默认密码：MaxKB@123..

官方文档：https://maxkb.cn/docs/v2/

# 二、配置模型及应用

二、 配置模型及应用

在成功部署并登录MaxKB后台后，我们需要配置知识库所使用的大模型，并创建一个具体的应用。MaxKB支持接入多种主流的大模型，例如ChatGPT、Claude、文心一言、通义千问等，也支持接入本地部署的开源模型。

## 添加模型：

在MaxKB管理后台，导航到“模型”。

选择想要接入的大模型服务提供商。

填写相应的API Key、API Secret等认证信息。如果是本地部署的模型，则需要填写模型的API地址。

配置模型的参数，如温度（Temperature）、最大token数等，以调整模型的输出效果。

## 创建知识库：

在后台找到“知识库”功能。

创建一个新的知识库，并为它取一个名字。

您可以选择上传本地文件（如PDF、Word、Markdown等）、导入网页链接或直接在后台编辑文本内容，作为知识库的数据源。

MaxKB会自动对导入的数据进行预处理，包括文本清洗、分块和向量化，以便于后续的检索。

## 创建应用：

在“应用”界面，点击“创建应用”。

选择应用类型，例如“问答机器人”。

在应用配置中，选择刚才添加的大模型和创建的知识库。

您可以设置应用的提示词（Prompt），以引导模型更好地回答问题。例如，您可以告诉模型：“你是一个基于[您的博客名称]知识库的智能助手，请根据知识库的内容回答用户的问题。”

配置好后，您可以进行测试，看看机器人是否能准确回答问题。

# 三、 将机器人集成到博客

应用创建并测试完成后，就可以将它集成到您的博客中了。

获取集成代码：

在应用的详情页面，找到“嵌入第三方”选项。

MaxKB通常会提供一段JavaScript代码片段。

![PixPin_2025-11-23_15-11-14.png](/static/img/5e79a839d77d3ff176743fe733788488.PixPin_2025-11-23_15-11-14.webp)

嵌入博客：

打开您博客的主题文件或页面模板（例如，如果您使用的是Hexo、Hugo等静态博客，可能需要修改主题的footer或layout文件）。

将获取的JavaScript代码粘贴到您希望问答机器人出现的位置，通常是在页面的右下角。

保存并重新部署博客。

现在，当用户访问博客时，就会看到一个智能问答机器人的图标，点击后即可向它提问，快速获取博客中的知识了！

# 总结

通过部署MaxKB，我们可以轻松地为博客添加一个基于大模型的智能问答功能。这不仅提升了用户体验，也让辛苦创作的内容能被更方便地检索和利用。随着您博客内容的不断丰富，这个智能助手的作用也会越来越大。