C2驾照科目一

# 在 Debian 服务器上部署 OpenWebUI + OpenRouter API（使用 Cloudflare DNS）

> 本文将介绍如何在 **Debian 系统** 上部署可通过浏览器访问的 **OpenWebUI 聊天界面**，并通过 **OpenRouter API** 接入大语言模型，实现一个自建的 ChatGPT 网页版。  
> 同时，我们将使用 **Cloudflare DNS** 配置域名，使服务可通过 `<ai.你的域名>` 直接访问。



---

## 一、工具与组件简介

### 1. OpenWebUI
[OpenWebUI](https://github.com/open-webui/open-webui) 是一个开源的 Web 聊天前端，支持接入本地模型（如 Ollama）或远程模型（如 OpenAI、OpenRouter）。  
它提供了现代化的聊天界面、用户系统、多模型支持等功能，是理想的自建 AI 前端。

---

### 2. OpenRouter API
[OpenRouter](https://openrouter.ai) 提供统一接口访问多家大模型（OpenAI、Anthropic、Mistral 等）。  
注册后可获得 API Key，格式如下：

```
sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

在 OpenWebUI 中配置该 Key 即可使用各类模型。

---

### 3. Cloudflare DNS
用于域名解析，将自有域名解析到服务器公网 IP。  
它还能提供反向代理、安全加速与 HTTPS 支持。

---

## 二、环境准备

确保系统为 **Debian / Ubuntu**，并具备以下条件：

- Python $\geqslant$ 3.11
- pip 与 venv 可用  
- 拥有一个可管理的域名 
- 已接入 Cloudflare DNS

### 安装必要依赖

```bash
sudo apt update
sudo apt install python3 python3-venv python3-pip git -y
```

---

## 三、安装 OpenWebUI

### 1. 创建虚拟环境并激活

```bash
mkdir -p /opt/openwebui
cd /opt/openwebui
python3 -m venv venv
source venv/bin/activate
```

### 2. 安装 OpenWebUI

```bash
pip install open-webui
```

### 3. 启动服务

```bash
openwebui serve
```

默认监听 **8080** 端口。  
可直接访问：

```
http://<服务器IP>:8080
```

第一次登录的账户将自动成为 **管理员账号**。

---

## 四、配置 Cloudflare DNS

登录 [Cloudflare 控制台](https://dash.cloudflare.com)：

1. 选择你的域名  
2. 添加一条 A 记录：  

```
名称：ai
内容：<你的服务器公网 IP>
代理状态：可选（灰云直连 / 橙云反代）
```

保存后可用命令测试：

```bash
ping ai.<你的域名>
```

若能解析出正确 IP，则说明域名配置成功。注意需要关闭DNS小彩云。

---

## 五、接入 OpenRouter API

1. 注册 [OpenRouter](https://openrouter.ai) 并复制 API Key  
2. 在 OpenWebUI 界面进入  
   **Admin Settings → Connections → OpenRouter**  
3. 粘贴你的 API Key 并保存  

---

## 六、通过 Caddy 反向代理

我们希望实现的架构是

```
[ Internet ]
      ↓
   ai.<你的域名>  ──(443/80)──▶  [Caddy] ──▶ localhost:8080 (OpenWebUI)
```

1. 安装 Caddy
```bash
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy
```
2. Caddy 配置

编辑`/etc/caddy/Caddyfile`，在其中添加:

```
ai.<你的域名> {
    reverse_proxy localhost:8080
}
```

3. 部署运行

```bash
sudo systemctl enable --now caddy
sudo systemctl restart caddy
```

---

## 七、开放所有模型权限给所有用户

默认情况下，普通用户无法访问管理员配置的所有模型。  
为了解决此问题，可设置环境变量：

```bash
BYPASS_MODEL_ACCESS_CONTROL=True
```

在虚拟环境中设置
```bash
source /openwebui/venv/bin/activate
export BYPASS_MODEL_ACCESS_CONTROL=True
openwebui serve
```
---

## 八、让 OpenWebUI 后台长期运行

### 简易方式：nohup
```bash
nohup openwebui serve > openwebui.log 2>&1 &
```

---

###  推荐方式：systemd 管理服务

创建文件 `/etc/systemd/system/openwebui.service`：

```ini
[Unit]
Description=Open WebUI
After=network-online.target
Wants=network-online.target

[Service]
Type=simple

# 你现在是放在 /root 下并用 root 跑；可先照抄
User=root
Group=root

WorkingDirectory=/root/openwebui

# 直接启动 venv 里的可执行文件
ExecStart=/root/openwebui/venv/bin/open-webui serve

# 让它异常退出自动拉起
Restart=on-failure
RestartSec=3

# 日志：二选一
# 方案A：写入 journald（推荐，默认就是这个；不写也行）
StandardOutput=journal
StandardError=journal

# 方案B：继续写文件（需要 systemd 240+ 支持 append:）
# StandardOutput=append:/root/openwebui/openwebui.log
# StandardError=append:/root/openwebui/openwebui.log

# 可选：如果你依赖某些环境变量（按需加）
# Environment="HOST=0.0.0.0"
# Environment="PORT=8080"

[Install]
WantedBy=multi-user.target
```

启用并启动：

```bash
sudo systemctl daemon-reload
sudo systemctl enable openwebui
sudo systemctl start openwebui
```

此后可通过以下命令查看状态：

```bash
sudo systemctl status openwebui
```

---

## 九、更新 OpenWebUI

当新版本发布时，只需在虚拟环境中执行：

```bash
source /openwebui/venv/bin/activate
pip install --upgrade open-webui
```

然后重启服务：

```bash
sudo systemctl restart openwebui
```

---

## 十、总结

至此，你已经完成以下配置：

| 项目 | 状态 |
|------|------|
| Cloudflare 域名解析 | ✅ |
| OpenWebUI 安装 | ✅ |
| OpenRouter 接口接入 | ✅ |
| 模型权限放开 | ✅ |
| 后台运行与开机自启 | ✅ |
| 自动更新机制 | ✅ |

现在你可以通过以下方式访问你的自建 AI 平台：

```
https://ai.<你的域名>
```

这是一个完全自建、现代化、安全的 AI 聊天系统 🎉

VPS部署OpenWebUI

在线LaTeX方案(Upmath)网站搭建

假设我们现在有域名<你的域名>，我们可以使用DNS提供商（以Cloudflare为例）的API定期更新IPv6。




1. DNS添加AAAA记录(指向你的IPv6)

登录[https://dash.cloudflare.com](https://dash.cloudflare.com)，在Cloudflare中加入域，并将你的域名的DNS解析服务器（你购买域名的服务商）替换成Cloudflare的DNS服务器，在该域名的DNS管理后台添加记录：
```
类型      名称     IPv6地址       代理状态     TTL
AAAA     www      <随便填一个>    仅DNS       2分钟
```
并在dash页面的该域名下的概述界面的右下角，获取您的API令牌，并在此处记住你的域名的区域ID（ZONE ID）。

2. 安装DDNS脚本
安装必要的软件（Debian系下）：
```
sudo apt install curl jq
```
创建一个如下脚本`/usr/local/bin/ddns-ipv6.sh`，注意修改配置部分的内容:
```Shell
#!/bin/bash

LOGFILE="/var/log/ddns-ipv6.log"
LAST_IP_FILE="/var/tmp/last_ipv6.txt"

touch $LOGFILE
chmod 644 $LOGFILE

echo "=== $(date) Starting DDNS update ===" >> $LOGFILE

# 配置部分
CF_API_TOKEN="<你的Cloudflare API Token>"
CF_ZONE_ID="<你的Zone ID>"
RECORD_NAME="<你的域名>"
NET_INTERFACE="enp0s31f6"  # 改为你的实际网卡名
TTL=120

# 日志函数
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a $LOGFILE
}

# 尝试多种方法获取可靠的公网IPv6
get_ipv6() {
    local ip_system=$(ip -6 addr show dev $NET_INTERFACE scope global \
        | grep -E 'global (dynamic|mngtmpaddr|temporary|permanent)' \
        | awk '/inet6/{print $2}' | cut -d'/' -f1 | head -1)

    local ip_api=$(curl -6 --connect-timeout 5 -s https://api64.ipify.org || \
                   curl -6 --connect-timeout 5 -s https://ipv6.icanhazip.com)

    [ -n "$ip_system" ] && echo $ip_system || echo $ip_api
}

# 获取当前IPv6
IP=$(get_ipv6)

if [ -z "$IP" ]; then
    log "错误：无法获取有效的IPv6地址"
    exit 1
fi

log "检测到的IPv6地址: $IP"

# 读取上一次的IP
if [ -f "$LAST_IP_FILE" ]; then
    LAST_IP=$(cat "$LAST_IP_FILE")
    if [ "$IP" = "$LAST_IP" ]; then
        log "IPv6地址未变化，无需更新 ($IP)"
        echo "=== $(date) Finished DDNS update ===" >> $LOGFILE
        exit 0
    else
        log "检测到IPv6已变化: $LAST_IP → $IP"
    fi
else
    log "首次运行，未检测到历史IP"
fi

# 获取记录ID
RESPONSE=$(curl -s -X GET "https://api.cloudflare.com/client/v4/zones/$CF_ZONE_ID/dns_records?type=AAAA&name=$RECORD_NAME" \
    -H "Authorization: Bearer $CF_API_TOKEN" \
    -H "Content-Type: application/json")

SUCCESS=$(echo "$RESPONSE" | jq -r '.success')
if [ "$SUCCESS" != "true" ]; then
    ERRORS=$(echo "$RESPONSE" | jq -r '.errors[]?.message')
    log "错误：获取记录ID失败 - $ERRORS"
    exit 1
fi

RECORD_ID=$(echo "$RESPONSE" | jq -r '.result[0].id')

if [ -z "$RECORD_ID" ] || [ "$RECORD_ID" = "null" ]; then
    log "错误：未找到记录 $RECORD_NAME，请先在Cloudflare创建此AAAA记录"
    exit 1
fi

log "找到记录ID: $RECORD_ID"

# 更新DNS记录
UPDATE_RESPONSE=$(curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$CF_ZONE_ID/dns_records/$RECORD_ID" \
    -H "Authorization: Bearer $CF_API_TOKEN" \
    -H "Content-Type: application/json" \
    --data "{\"type\":\"AAAA\",\"name\":\"$RECORD_NAME\",\"content\":\"$IP\",\"ttl\":$TTL,\"proxied\":false}")

UPDATE_SUCCESS=$(echo "$UPDATE_RESPONSE" | jq -r '.success')
if [ "$UPDATE_SUCCESS" = "true" ]; then
    NEW_CONTENT=$(echo "$UPDATE_RESPONSE" | jq -r '.result.content')
    log "成功更新记录! $RECORD_NAME → $NEW_CONTENT"
    echo "$IP" > "$LAST_IP_FILE"   # 保存新IP
else
    ERRORS=$(echo "$UPDATE_RESPONSE" | jq -r '.errors[]?.message')
    log "错误：更新记录失败 - $ERRORS"
    exit 1
fi

echo "=== $(date) Finished DDNS update ===" >> $LOGFILE
```
并添加权限
```
chmod +x /usr/local/bin/ddns-ipv6.sh
```

3. 使用crontab定时任务自动更新
```
crontab -e
```
加入
```
*/5 * * * * /usr/local/bin/ddns-ipv6.sh >/var/log/ddns-ipv6.log 2>&1
```
这样每5分钟检测一次IPv6变化并更新DNS。

DDNS配置IPv6

# 张量积 II

## 1. 简介

继续研究张量乘积，我们将看到如何把两个线性映射 $M \rightarrow M^{\prime}$ 和 $N \rightarrow N^{\prime}$ 结合成一个线性映射$M \otimes_{R} N \rightarrow M^{\prime} \otimes_{R} N^{\prime}$。这就引出了平坦模块和基扩张之间的线性映射。然后，我们将研究向量空间的张量积（包括缩并）的特殊性，$R$-代数的张量积以及最后的$R$-模的张量代数。



## 2. 线性映射中的张量积

## 3. 平坦模

## 4. 线性映射和基扩张的张量积

## 5. 向量空间

## 6. 张量缩并

## 7. $R$-代数的张量积

## 8. $R$-模的张量代数

在 Debian 服务器上部署 OpenWebUI + OpenRouter API（使用 Cloudflare DNS）

§\S§ 1 Upmath项目简介

张量积 II

1. 简介

$\S$ 1 Upmath项目简介