### 一、什么是RAG?
RAG（Retrieval-Augmented Generation，检索增强生成） 是一种让大语言模型（LLM）"开卷考试"的技术。传统 AI 只能依赖训练数据回答问题，而 RAG 让 AI 能够实时检索你的私人文档、笔记或数据库，再基于这些内容生成精准回答.




### 二、何为RAG系统

```
┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  文档来源    │────▶│  文本分块    │────▶│  向量数据库  │
│ (Drive/PDF) │     │  + Embedding │     │(Pinecone/  │
└─────────────┘     └──────────────┘     │ Supabase)   │
                                         └──────┬──────┘
                                                │
┌─────────────┐     ┌──────────────┐     ┌──────▼──────┐
│   用户查询   │────▶│   相似性检索  │◀────│  向量存储   │
│ (Chat/Web)  │     │  (Top-K)     │     └─────────────┘
└─────────────┘     └──────┬───────┘
                           │
                    ┌──────▼──────┐     ┌─────────────┐
                    │   LLM 生成   │────▶│   返回回答   │
                    │(GPT-4/Claude)│     └─────────────┘
                    └─────────────┘
```
### 三、RAG系统搭建部署（n8n）
##### 1. 相关软件及其环境的安装
1. docker(win中文版)
2. n8n
3. chroma / Pinecone(这是云端免费服务商)

```
docker安装地址(中文版win)：https://github.com/asxez/DockerDesktop-CN
```

```docker(win)


docker run -d `
  --name n8n `
  --restart always `
  --network my_network `
  -p 5678:5678 `
  -e GENERIC_TIMEZONE="Asia/Shanghai" `
  -e TZ="Asia/Shanghai" `
  -e N8N_DEFAULT_LOCALE=zh-CN `
  -e N8N_SECURE_COOKIE=false `
  -e N8N_HOST=47.110.26.14 `
  -e N8N_PROTOCOL=http `   # https也可
  -e WEBHOOK_URL=http://47.110.26.14:5000 `
  -v /d/works/n8n/n8nAI:/home/node/.n8n `
  -v /d/works/n8n/n8ndata:/home/node/n8ndata `
  docker.n8n.io/n8nio/n8n
```

```docker(win)
docker run -d `
  --name chromadb `
  --restart always `
  --network my_network `
  -p 5680:8000 `
  -e IS_PERSISTENT=TRUE `
  -e CHROMA_SERVER_HOST=0.0.0.0 `
  -v /d/works/chroma:/data `
  chromadb/chroma:latest
```
##### 2. n8n布局

ai智能体模块
![image.png](https://oss.cokey.top/vanblog/baef7de8292e409b12bcc0e2a4b272be.image.webp)

chroma上传管理模块
![image.png](https://oss.cokey.top/vanblog/9db3650b05ee33dced605a84e51f29b0.image.webp)
agents系统提示词

```
# Role & Persona
你是“小娜”，是“可可”的专属私人助理。请始终以友好、专业的口吻称呼用户为“可可”。你有最高权限处理并回答用户的隐私及专属上下文问题。禁止使用“作为AI我不知道”、“我的训练数据截止到…”或“涉及隐私无法回答”等套话。

# Core Workflow (严格的执行顺序)
面对可可的任何提问，你必须**严格遵守**以下工具调用顺序，绝对不能跳过检索步骤直接使用你的内部训练数据回答：

1. **第一步：强制调用本地知识库 (Vector Store Tool)**
   遇到任何问题，你**必须首先**调用“Answer questions with a vector store”工具检索本地知识库。这是你获取准确信息的最优先、最核心来源。
2. **第二步：互联网回退 (Tavily Search Tool)**
   只有当向量数据库明确返回“未找到相关内容”，或者返回的片段不足以完整回答问题时，你才被允许调用“Search in Tavily”工具进行全网补充搜索。
3. **第三步：深度思考 (Think Tool)**
   在获取了向量数据库或搜索引擎的事实资料后，如果问题涉及复杂的逻辑推理、数据分析、多步规划或代码编写，请调用“Think”工具进行深度推理，然后再输出最终答案。

# Output Constraints
- **禁止凭空捏造（Hallucination）：** 你的回答必须基于向量库或搜索引擎返回的事实。
- **诚实兜底：** 如果即使使用了向量库和网络搜索，依然找不到答案，请诚实地告诉可可你已经尝试了全面检索但未能找到，并询问是否需要提供更多背景信息，绝不要直接回答“不知道”。
```
chroma模块Basic LLM Chain提示词

```
“你是一个专业的数据清洗与文本排版助手。请阅读以下由机器从文件中暴力提取的原始文本片段。
你的任务是：
剔除乱码与杂质： 删掉所有由于提取造成的无意义乱码、奇怪的特殊符号、以及不连贯的页眉页脚数字。
修复排版与断句： 修复因换行导致的断句错误，将文本重新排版为逻辑通顺、易于阅读的连贯段落。
100% 无损保留： 绝对禁止对原文进行任何形式的精简、总结、归纳或删减。你必须保留原文中所有的原理论述、细节限定、具体例子以及专业术语。
请直接输出清洗排版后的纯文本，不要包含任何开场白或解释性废话。

```

:::info{title="相关信息"}
#### 需要源文件的可以私我
:::

基于n8n个人RAG系统搭建

### 一、准备autherlia安装包
https://github.com/authelia/authelia



![image.png](https://oss.cokey.top/vanblog/d0c42eb22247893c20c9ee9a98e0a0c1.image.webp)
### 二、创建配置文件
##### 1.运行起来的大致布局（先看一下哈）

![image.png](https://oss.cokey.top/vanblog/11d9c4c38fb8a0582be5c39c960af80b.image.webp)
 ##### 2.手动创建文件`users_database.yml`里面放入用户数据
 格式大概如下

![image.png](https://oss.cokey.top/vanblog/703afc74f947833e55c964e012f2c80c.image.webp)
示例程序

```yml
users:
  admin: # 自定义账号
    displayname: "Admin"
    password: "$argon2id$v=19$m=65536,t=3,p=4$UC+yj8d9Vd2WjftBMi56PQ$7vBnyxZoJ4ZDseMK2fyA/OhvA9K7uFK5R0V06Ep3D+E" # 自定义密码，注意：这个密码必须是通过argon2推导函数加密后的密码可以在项目目录运行这个指令加密你的密码：./authelia crypto hash generate argon2
    email: admin@test.com # 修改密码时需要邮箱验证（可以默认）
    groups:
      - admins
```
##### 3.手动创建文件`configuration.yml`里面放入authelia的配置文件
示例程序

```yml
server:
  address: 0.0.0.0:9091 # 监听端口

identity_validation:
  reset_password:
    jwt_secret: "9b7e4c0e4d7eddf25b3e4dfhjefdf9d8e" # 重置密码时的认证密钥一般用不到注意不要泄露可自定义32位以上

authentication_backend:
  file:
    path: /opt/authelia/users_database.yml # users_database.yml文件路径
    
regulation:
  max_retries: 3 # 最大登录错误次数
  find_time: 2m # 2分钟内
  ban_time: 1h # 封ip1小时

access_control: # 规则配置(注意：从上往下配对)
  default_policy: two_factor
  rules:
    - domain: "auth.cokey.top" # 服务网页
      policy: one_factor # 这个必须为one...
      
    - domain: "text1.cokey.top"
      resources: # 只保护单路径需要配置
        - "^/admin.*"
      policy: two_factor
      
    - domain: "text2.cokey.top"
      policy: one_factor 
      
    - domain: "*.cokey.top" # （全部子域名）
      policy: two_factor
    

session:
  secret: "2a6f9c0b7hfjahdudwf8b7d6e5c4a3b2f" # 自己设置32位以上
  cookies:
    - domain: "cokey.top" # 根域名（根据实际修改）
      authelia_url: "https://auth.cokey.top" # 服务部署的域名（根据实际修改）

storage:
  encryption_key: "6f4e3dwdjwiadidwe6d5c4b3a2f1e0d9c" # 数据库加密密钥自己设置32位以上
  local:
    path: /opt/authelia/db.sqlite3 # 数据库位置（启动后自动创建，删除后2fa要重新注册）

notifier:
  filesystem:
    filename: /opt/authelia/notification.txt # 注册2fa时需要验证码（在这里面）
```
##### 4.启动运行注册第一个2fa
启动命令（别忘了给文件赋予运行权限）

```
./authelia --config configuration.yml
```
##### 5.后面就是守护进程，nginx对接（重点）后面提供对接部分参考程序
如果是全站守护

```
location / {

    auth_request /authelia; # 添加这两行
    error_page 401 = @authelia_signin;

    proxy_pass http://127.0.0.1:5244; # 注意端口
}



# ......省略部分


# ==============================
# Authelia 官方认证接口
# ==============================

location = /authelia {
    internal;
    proxy_pass http://127.0.0.1:9091/api/verify;

    proxy_set_header Host $host;
    proxy_set_header X-Original-URL $scheme://$http_host$request_uri;
    proxy_set_header X-Real-IP $remote_addr;

    proxy_pass_request_body off;
    proxy_set_header Content-Length "";
}

location @authelia_signin {
    return 302 https://auth.cokey.top/?rd=$scheme://$host$request_uri; # 注意域名
}

```
如果是单路径下全守护

```
location ^~ /admin {

    auth_request /authelia; # 添加整个location ^~ /admin {...
    error_page 401 = @authelia_signin;

    auth_request_set $user $upstream_http_remote_user;
    auth_request_set $groups $upstream_http_remote_groups;

    proxy_pass http://127.0.0.1:4001;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $http_connection;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Port $server_port;
    proxy_http_version 1.1;
}

location / {
    proxy_pass http://127.0.0.1:5244; # 注意端口
}


# ......省略部分



# ==============================
# Authelia 官方认证接口
# ==============================

location = /authelia {
    internal;
    proxy_pass http://127.0.0.1:9091/api/verify;

    proxy_set_header Host $host;
    proxy_set_header X-Original-URL $scheme://$http_host$request_uri;
    proxy_set_header X-Real-IP $remote_addr;

    proxy_pass_request_body off;
    proxy_set_header Content-Length "";
}

location @authelia_signin {
    return 302 https://auth.cokey.top/?rd=$scheme://$host$request_uri;
}

```
:::danger{title="警告"}
保护的服务全部走内网127.0.0.1然后nginx反代+对接auhtelia、否则保护无效可以直接绕过防护
:::

authelia-2fa网关验证搭建

### 一、下载所需软件


> https://www.oracle.com/java/technologies/downloads/#jdk25-windows
> 
> https://github.com/Meloong-Git/PCL
> 
> https://minecraftversions.org/cn/1-20-4/
> 



![](https://oss.cokey.top/vanblog/29c8fff2192e5ae4a3bd3c5979b8e5dc.clipboard-2026-03-17.webp)

#### 前两个文件可以确保玩家正常游玩MC.JS 。第三个是本地搭建服务器邀请盆友游玩的文件。


### 二、启动游戏
1. #### 先运行第一个文件给本地配置js环境。
2. #### 解压第二个文件得到`Plain Craft Launcher 2.exe`
3. #### 运行`Plain Craft Launcher 2.exe`会在同路径下自动创建`.minecraft文件夹`
### 如果是桌面的话会得到下面的前三个
![](https://oss.cokey.top/vanblog/f7702f03f54e4b1f3dd3cc1f0f3e53fc.clipboard-2026-03-17.webp)

4. #### 打开`Plain Craft Launcher 2.exe`下载对应版本及其模组
![](https://oss.1701700.xyz/vanblog/eadce57c7ccbdb9f8ac202cab00252b0.clipboard-2026-03-17.webp)

5. #### 进入游戏（没买正版离线模式即可）已经可以进入游戏了。

### 三、联机方法
### 方法一：
#### 本地游戏开放至局域网、下载联机mod(主要是魔改游戏局域网玩家限制，允许非正版玩家游玩)
![](https://oss.cokey.top/vanblog/61e325401adaab8c991915ccb25fcc91.clipboard-2026-03-17.webp)
![](https://oss.cokey.top/vanblog/cc31a1f1fa3b14ae0353eed45dde7d06.clipboard-2026-03-17.webp)
### 方法二：
#### 1. 本地运行服务器、下载上文第四个文件`server.jar`放到一个自己喜欢的文件夹，然后自己建一个bat启动脚本(代码如下)和`server.jar`放一起

```bat
java -Xmx4G -Xms2G -jar server.jar nogui
pause
```
#### 2. 运行把他脚本它会自动创建一些文件，在运行一次（启动服务器创建地图及其重要组件world）,你会得到一下文件（重要的已标注） 

![image.png](https://oss.cokey.top/vanblog/58d6abeaa0b0adc45ff517ad8c54b37f.image.webp)
#### 3. worid放你的地图、server.properties服务器配置文件（如修改端口默认25565，允许非正版玩家进入）


![image.png](https://oss.cokey.top/vanblog/4118d2b5d2716d5063f933628503bcd0.image.webp)
完成配置后运行启动bat脚本即可
### 三、地图，光影....导入请去b站大学自学。

MC我的世界js（安装，自建服务器联机教程）

### 一、frp安装包下载
>  选择对应版本本文为frp_0.67.0_linux_amd64、
> 下载地址` https://github.com/fatedier/frp/releases/`



>  ![](https://oss.cokey.top/vanblog/3373d9b5f3b1beda02e9f13e7a55ad51.clipboard-2026-03-11.webp)

### 二、frp解压赋予运行权限
> 1.解压放在喜欢的的位置本文放在`/home/frp/frp_0.67.0_linux_amd64`、
> 解压后可以清楚的看到有5个文件
> 服务端只会用到frps、frps.toml两个文件。
> ![](https://oss.cokey.top/vanblog/fec8c21cc380b2a354a96f279eed5aa4.clipboard-2026-03-11.webp)
> 2.赋予frp运行权限
> ```
> chmod 700 /home/frp/frp_0.67.0_linux_amd64/frps
> ```

### 三、frp配置文件
> 编辑frp.toml文件为以下内容
> ```
> bindPort = 40001
> auth.method = "token"
> auth.token = "123456"
> # 连接池限制
> transport.maxPoolCount = 10
> #监听443端口
> vhostHTTPSPort = 443
> #代理主域名
> subdomainHost = "cokey.top"
> # 强制stl加密传输
> transport.tls.force = true
> # 证书配置在 tls 下
> transport.tls.certFile = "/home/frp/frp_0.67.0_linux_amd64/key/fullchain.pem"
> transport.tls.keyFile = "/home/frp/frp_0.67.0_linux_amd64/key/privkey.pem"
> # 可选：Dashboard 面板
> webServer.addr = "0.0.0.0"
> webServer.port = 40000
> webServer.user = "admin"
> webServer.password = "123456"
> ```


### 四、启动frp
> 运行启动命令
> ```
> /home/frp/frp_0.67.0_linux_amd64/frps -c /home/frp/frp_0.67.0_linux_amd64/frps.toml
> ```
> :::warning{title="注意"}
> 启动测试前要放行：面板监听端口、穿透服务端口
> :::
> ![](https://oss.cokey.top/vanblog/f7c0f8db5ef77d27f689676c9b66b234.clipboard-2026-03-11.webp)
### 五、设置开机自启
> **不同的系统不一样、直接人工智能**😍
> 下面以Alpine系统为例
> 创建`/etc/init.d/frps`文件内容如下，别忘了赋予可执行权限
> 

```
#!/sbin/openrc-run

name="frps"
description="FRP Server"
command="/home/frp/frp_0.67.0_linux_amd64/frps"
command_args="-c /home/frp/frp_0.67.0_linux_amd64/frps.toml"
command_user="nobody"

pidfile="/run/${RC_SVCNAME}.pid"
command_background=true

depend() {
    need net
}
```
接下来：
```
# 1. 安装 libcap 工具包
apk add libcap

# 2. 重新赋予 frps 绑定 443 等低端口的权限
setcap 'cap_net_bind_service=+ep' /home/frp/frp_0.67.0_linux_amd64/frps

# 3.给 frps 加上可执行权限
chmod +x /home/frp/frp_0.67.0_linux_amd64/frps

# 4.收回配置文件的可执行权限，改为普通的可读写
chmod 644 /home/frp/frp_0.67.0_linux_amd64/frps.toml
```


:::info{title="相关信息"}
重启命令：rc-service frps restart

状态命令：rc-service frps status

:::

### 六、客户端下载
下载地址`https://github.com/koho/frpmgr`

FRP内网穿透搭建

### 1. 复制脚本编辑保存为 traffic_kill.sh



```sh
#!/bin/sh
STATE="/root/.traffic_state"
LOG_FILE="/root/traffic_monitor.log"
LIMIT_GB=10
LIMIT=$((LIMIT_GB * 1024 * 1024 * 1024))

IFACE=$(ip route 2>/dev/null | grep default | awk '{print $5}' | head -1)
[ -z "$IFACE" ] && IFACE="eth0"

# 获取当前网卡总字节数 (接收 + 发送)
BYTES=$(awk -v iface="$IFACE" 'NR>1{split($1,a,":"); if(a[1]==iface){print $2+$10; exit}}' /proc/net/dev)
[ -z "$BYTES" ] && exit 0

TODAY=$(date +%Y-%m-%d)

# 初始化变量
ACC_BYTES=0       # 今日累计流量
LAST_KERNEL=0     # 上次记录的网卡内核计数值
LAST_DATE=""

# 读取状态文件
if [ -f "$STATE" ]; then
    ACC_BYTES=$(grep "^acc_bytes=" "$STATE" 2>/dev/null | cut -d= -f2)
    LAST_KERNEL=$(grep "^last_kernel=" "$STATE" 2>/dev/null | cut -d= -f2)
    LAST_DATE=$(grep "^last_date=" "$STATE" 2>/dev/null | cut -d= -f2)
fi

# 初始化保护 (如果是第一次运行或状态文件缺失)
[ -z "$ACC_BYTES" ] && ACC_BYTES=0
[ -z "$LAST_KERNEL" ] && LAST_KERNEL=$BYTES

# 1. 日期变更：重置累计流量
if [ "$TODAY" != "$LAST_DATE" ]; then
    ACC_BYTES=0
    LAST_KERNEL=$BYTES
fi

# 2. 计算本次增量
DELTA=$((BYTES - LAST_KERNEL))

# 3. 检测网卡重启/计数器归零 (增量变负数)
if [ "$DELTA" -lt 0 ] 2>/dev/null; then
    # 网卡重置了，增量视为 0，但保留之前的 ACC_BYTES 不清零
    DELTA=0
    # 记录重置事件到日志，方便排查
    echo "$(date '+%Y-%m-%d %H:%M:%S') - INFO: Network counter reset detected. Keeping accumulated traffic." >> "$LOG_FILE"
fi

# 4. 累加到今日总用量
ACC_BYTES=$((ACC_BYTES + DELTA))

# 更新 LAST_KERNEL 为当前值，供下次计算增量
LAST_KERNEL=$BYTES

# 格式化显示 (GB)
USED_GB=$(awk "BEGIN {printf \"%.2f\", $ACC_BYTES/1024/1024/1024}")
echo "Today Total: ${USED_GB} GB / ${LIMIT_GB} GB"

# 记录日志 (显示累计用量)
echo "$(date '+%Y-%m-%d %H:%M:%S') - Total Usage: ${USED_GB}GB / ${LIMIT_GB}GB" >> "$LOG_FILE"

# 5. 判断是否超限
if [ "$ACC_BYTES" -gt "$LIMIT" ]; then
    echo "!!! 流量超限，执行关机 !!!"
    echo "$(date '+%Y-%m-%d %H:%M:%S') - WARNING: LIMIT EXCEEDED! SHUTTING DOWN!" >> "$LOG_FILE"
    
    # 保存状态 (虽然马上要关机，但保持习惯)
    echo "acc_bytes=$ACC_BYTES" > "$STATE"
    echo "last_kernel=$LAST_KERNEL" >> "$STATE"
    echo "last_date=$TODAY" >> "$STATE"
    chmod 600 "$STATE"
    
    poweroff -f
fi

# 6. 保存状态
echo "acc_bytes=$ACC_BYTES" > "$STATE"
echo "last_kernel=$LAST_KERNEL" >> "$STATE"
echo "last_date=$TODAY" >> "$STATE"
chmod 600 "$STATE"

```
### 2.把文件放在/root/traffic_kill.sh 授予执行权限


赋予执行权限

```
chmod 700 /root/traffic_kill.sh
```
状态文件重置（改阈值的事后最好重置一下，然后再手动测试）

```
rm -f /root/.traffic_state
```

手动测试

```
/root/traffic_kill.sh
```
查看生成的日志

```
cat /root/traffic_monitor.log
```
### 3.设置定时执行该脚本
修改安装源为阿里云

```
sed -i 's|https\?://[^/]*/alpine/|https://mirrors.aliyun.com/alpine/|g' /etc/apk/repositories

sed -i 's|/v[0-9.]*/|/latest-stable/|g' /etc/apk/repositories
```
安装并配置 cron（Alpine Linux）

```
# 安装 cron
apk add --no-cache openrc dcron

# 设置开机自启
rc-update add dcron

# 启动 cron 服务
rc-service dcron start
```
添加定时任务
```
# 使用 crontab -e 编辑（推荐）
crontab -e
# 添加以下内容：
@reboot /root/traffic_kill.sh

*/1 * * * * /root/traffic_kill.sh
```
:::note{title="注意"}
1.按 i 键进入插入模式

2.输入以下两行（确保每行一个任务）：

@reboot /root/traffic_kill.sh

*/1 * * * * /root/traffic_kill.sh

3.按 ESC 键退出插入模式

4.输入 :wq 保存并退出
:::

 验证设置
 
```
# 验证 cron 服务状态
rc-service dcron status

# 查看开机自启
rc-update show | grep dcron

# 查看 crontab 内容
crontab -l
```
等待定时查看***状态文件***验证定时任务是否生效

```
cat /root/.traffic_state
```

:::info{title="返回的状态信息内容解读"}
acc_bytes=107857179  #单日累计字节数

last_kernel=1364664  #上次统计的字节数

last_date=2026-03-12  #上次统计的时间
:::