# 一、ad-hoc模式
- 在 Ansible 中，ad-hoc 模式（临时命令模式）是一种快速执行单个或简单任务的方式，无需编写复杂的 Playbook，适合临时排查问题、执行一次性操作（如批量命令、检查状态、简单配置等）。

- 核心特点：
- 临时性：用于执行简单、一次性的任务（如 “批量重启服务器”“查看所有主机磁盘使用率”）。
- 无需 Playbook：直接通过命令行输入指令，无需编写 YAML 格式的 Playbook 文件。
- 依赖模块：通过调用 Ansible 的内置模块（如ping、command、yum等）实现功能。

## ad-hoc 命令的基本格式：
```js
ansible <目标主机/组> -m <模块名> -a <模块参数> [其他选项]
```

## 测试主机连通性（ping模块）

```js
# 测试elk1组的连通性
ansible elk1 -m ping

# 测试所有主机（all是内置组，包含所有定义的主机）
ansible all -m ping
```



## 执行 shell 命令（command或shell模块）
```js
# 查看elk2组主机的 hostname
ansible elk2 -m command -a 'hostname'

# 查看elk1主机的磁盘使用率（用shell模块支持管道|）
ansible elk1 -m shell -a 'df -h | grep /'
```
## copy 模块的作用
copy 模块只能 控制机 → 远程主机 复制
```js
# ansible <目标主机/组> -m copy -a 'src=本地路径 dest=远程路径 [其他参数]'
ansible elk1 -m copy -a 'src=/tmp/elk.conf dest=/etc/elk/elk.conf'
```

## fetch 模块
远程主机 → 控制机 拉取文件

```js
# 拉取 elk1 主机的 /var/log/elk.log 到控制机的 /tmp/remote_logs/ 目录（自动按主机IP分目录）
ansible elk1 -m fetch -a 'src=/var/log/elk.log dest=/tmp/remote_logs/'
```

## 批量创建文件 / 目录（file模块）


```js
# 在elk1和elk2所有主机上创建/tmp/elk目录
ansible elk1:elk2 -m file -a 'path=/tmp/elk state=directory mode=0755'
```
## 安装软件（yum模块，需 root 权限）

```js
# 在elk1组安装nginx（假设远程用户是root）
ansible elk1 -m yum -a 'name=nginx state=present'
```
## 重启服务（service模块）

```js
# 重启elk2组的sshd服务
ansible elk2 -m service -a 'name=sshd state=restarted'
```



2.Ansible常用模块

# 一、概述


1. 功能	说明
2. 端口映射	将内部服务器（HTTP、TCP、UDP 等）映射到 frps（服务器端）的公开 IP+端口。
3. 多协议支持	HTTP, HTTPS, TCP, UDP, WebSocket 等多种协议。
4. 多路复用	一个 frps 进程可以同时处理成百上千条 frpc 连接，支持多域名和多端口。
5. TLS/SSL 加密	支持 TLS/SSL 双向加密，保证数据传输安全。
6. 自定义域名	通过 custom_domains 或 https 配置，可以把内部服务绑定到自定义域名。
7. 访问控制	IP 白名单/黑名单、token 认证、访问日志等。
8. 高可用	支持主从、负载均衡、集群部署。

![image.png](/static/img/63fb5dc096ca209f4f94b3dd18adc999.image.webp)

# 二、公网服务器设置
https://github.com/fatedier/frp

然后在公网服务器进行解压

```js
wget https://github.com/fatedier/frp/releases/download/v0.51.3/frp_0.51.3_linux_amd64.tar.gz
tar -zxvf frp_0.51.3_linux_amd64.tar.gz
cd frp_0.51.3_linux_amd64
```
修改服务端配置文件frps.ini

```js
vi frps.ini
```

```yml
[common]
# frp客户端与服务端的通信端口（不变）
bind_port = 7000  

# 公网用户访问的端口（关键，设为8080）
vhost_http_port = 8080  
```


```js
pkill frps  # 结束旧进程
cd frp_0.51.3_linux_amd64  # 进入frp目录
nohup ./frps -c ./frps.ini &  # 后台启动
```


# 三、内网服务器设置
```js
wget https://github.com/fatedier/frp/releases/download/v0.51.3/frp_0.51.3_linux_amd64.tar.gz
tar -zxvf frp_0.51.3_linux_amd64.tar.gz
cd frp_0.51.3_linux_amd64
```
修改服务端配置文件frpc.ini

```js
vi frpc.ini
```

```yml
[common]
#公网服务器的公网IP
server_addr = 123.123.123.123

# 与frps的bind_port一致
server_port = 7000  

# Web服务转发规则（名称[web]可自定义）
[web]
# 协议类型为HTTP
type = http 

# 虚拟机的内网IP（目标IP）
local_ip = 192.168.183.120 
# 虚拟机内Web服务的端口（目标端口）
local_port = 80  
# 公网访问时的IP（填公网服务器IP）
custom_domains = 公网服务器的公网IP  
```

```js
pkill frpc  # 结束旧进程
cd frp_0.51.3_linux_amd64  # 进入frp目录
./frpc -c ./frpc.ini  # 前台启动（查看日志，确认成功）
```

测试访问
```js
http://公网服务器的公网IP:8080
```

# 四、其他案例
如需开放访问多个虚拟机的端口

公网 9000 端口→内网 9090 端口” 的转发，和原有 “8080→80

修改服务端配置文件frpc.ini


```js
vi frpc.ini
```
```js
[common]
server_addr = 公网服务器IP  # 不变
server_port = 7000          # 不变

# 已有的Web服务规则（80端口）
[web]
type = http
local_ip = 192.168.183.120
local_port = 80
custom_domains = 公网服务器IP

# 新增规则：公网9000→内网9090（TCP类型）
[app9090]  # 规则名称，自定义（不能和已有名称重复，比如叫app9090）
type = tcp  # 非HTTP服务用TCP类型
local_ip = 192.168.183.120  # 还是你的虚拟机内网IP
local_port = 9090           # 目标内网端口（你要转发的9090）
remote_port = 9000          # 公网访问时的端口（用9000）
```

frp实现内网穿透

RAGFlow构建本地知识库

# 一、编写K8S的yml文件
先创建一个PV用于存储

```js
vi open-webui-pv.yaml
```
```yml
apiVersion: v1
kind: PersistentVolume
metadata:
  name: open-webui-pv  # PV 名称，需与后续绑定逻辑对应
spec:
  capacity:
    storage: 10Gi  # 容量必须与 PVC 请求的 10Gi 一致
  accessModes:
    - ReadWriteOnce  # 访问模式必须与 PVC 的 ReadWriteOnce 一致
  hostPath:
    path: /data/open-webui  # 节点上的本地目录（需在目标节点手动创建）
    type: DirectoryOrCreate  # 若目录不存在，自动创建
  storageClassName: ""  # 存储类必须与 PVC 一致（空，表示不使用存储类）
  persistentVolumeReclaimPolicy: Delete  # PVC 删除后，自动删除 PV（避免残留 Released 状态）
  # 可选：限制 PV 只能被特定节点使用（若需要固定节点，取消注释并修改节点名称）
  # nodeAffinity:
  #   required:
  #     nodeSelectorTerms:
  #     - matchExpressions:
  #       - key: kubernetes.io/hostname
  #         operator: In
  #         values:
  #         - k8s-node01  # 替换为你的目标节点名称（如 k8s-node01）
```
然后每个节点都创建好存放的目录

```js
mkdir -p /data/open-webui
```
然后启动
```js
kubectl apply -f open-webui-pv.yaml
```
再写一个open-webui.yaml

```js
vi open-webui.yaml
```

```js
apiVersion: v1
kind: PersistentVolume
metadata:
  name: open-webui-pv  # PV 名称，需与后续绑定逻辑对应
spec:
  capacity:
    storage: 10Gi  # 容量必须与 PVC 请求的 10Gi 一致
  accessModes:
    - ReadWriteOnce  # 访问模式必须与 PVC 的 ReadWriteOnce 一致
  hostPath:
    path: /data/open-webui  # 节点上的本地目录（需在目标节点手动创建）
    type: DirectoryOrCreate  # 若目录不存在，自动创建
  storageClassName: ""  # 存储类必须与 PVC 一致（空，表示不使用存储类）
  persistentVolumeReclaimPolicy: Delete  # PVC 删除后，自动删除 PV（避免残留 Released 状态）
  # 可选：限制 PV 只能被特定节点使用（若需要固定节点，取消注释并修改节点名称）
  # nodeAffinity:
  #   required:
  #     nodeSelectorTerms:
  #     - matchExpressions:
  #       - key: kubernetes.io/hostname
  #         operator: In
  #         values:
  #         - k8s-node01  # 替换为你的目标节点名称（如 k8s-node01）
[root@k8s-master01 openwebAI]# 
[root@k8s-master01 openwebAI]# cat open-webui.yaml 
# 持久化存储声明（不变）
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: open-webui-data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: ""
---
# Deployment（更新资源配置）
apiVersion: apps/v1
kind: Deployment
metadata:
  name: open-webui
spec:
  replicas: 1
  selector:
    matchLabels:
      app: open-webui
  template:
    metadata:
      labels:
        app: open-webui
    spec:
      containers:
      - name: open-webui
        image: ghcr.io/open-webui/open-webui:main
        ports:
        - containerPort: 8080
        env:
        - name: OLLAMA_BASE_URL
          value: "http://192.168.201.120:11434"
        # 资源配置：最少2核4G，最多4核8G（核心修改）
        resources:
          requests:  # 启动时至少分配的资源（保证基础运行）
            cpu: 2000m  # 2核（1核=1000m）
            memory: 2Gi  # 4G内存（1Gi≈1G）
          limits:  # 最多能使用的资源（避免占用过多）
            cpu: 3000m  # 4核
            memory: 4Gi  # 8G内存
        volumeMounts:
        - name: data-volume
          mountPath: /app/backend/data
      volumes:
      - name: data-volume
        persistentVolumeClaim:
          claimName: open-webui-data
---
# Service（不变）
apiVersion: v1
kind: Service
metadata:
  name: open-webui-service
spec:
  selector:
    app: open-webui
  type: NodePort
  ports:
  - port: 8080
    targetPort: 8080
    nodePort: 30000
```
启动
```js
kubectl apply -f open-webui.yaml
```
这时就分配到该节点运行了，用该节点的IP+service暴露的端口号30000进行访问
![image.png](/static/img/e90a25e9ce56cc5e8d4ba6e6c0baa794.image.webp)


![image.png](/static/img/f3803cbb7ed5f975cf41e7cb1532a015.image.webp)


3.K8S访问Ollama对外提供AI服务

# 一、下载安装ollama

```js
curl -fsSL https://ollama.com/install.sh | sh
```
红色是因为我是虚拟机没有显卡只能用CPU
![image.png](/static/img/0e9faa04ce4baacb85f1411582b3697e.image.webp)

 测试下载一个llama3 模型
```js
ollama run llama3
```
完成下载后测试
![image.png](/static/img/2ca736f33c496b27875f535187ca83bd.image.webp)

# 二、让局域网其他设备访问
Ollama 仅允许本机访问，若需局域网其他设备调用，需修改配置让其监听全网地址：
```js
vim /etc/systemd/system/ollama.service
```
修改后如下：
```js
[Unit]
Description=Ollama Service
After=network-online.target

[Service]
Environment="OLLAMA_HOST=0.0.0.0"
ExecStart=/usr/local/bin/ollama serve
User=ollama
Group=ollama
Restart=always
RestartSec=3
Environment="PATH=/root/.local/bin:/root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"

[Install]
WantedBy=default.target

```


然后重启服务

```js
sudo systemctl daemon-reload
sudo systemctl restart ollama
```
之后局域网设备可通过 http://你的LinuxIP:11434 调用 API（例如用 curl 或 Web 界面）


然后安装docker 运行一个web界面，启动后访问IP+3000

```js
docker run -d -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://192.168.201.120:11434 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main
```

docker-compose方式
```yml
version: '3.8'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui  # 容器名称，与原命令一致
    ports:
      - "3000:8080"  # 端口映射，主机3000端口映射到容器8080端口
    environment:
      - OLLAMA_BASE_URL=http://192.168.201.120:11434  # Ollama服务地址，与原命令一致
    volumes:
      - open-webui:/app/backend/data  # 数据卷挂载，持久化存储对话历史、配置等
    restart: always  # 容器退出时自动重启（可选，推荐加上）
    networks:
      - open-webui-network  # 独立网络，避免与其他容器冲突

volumes:
  open-webui:  # 声明数据卷，确保数据持久化

networks:
  open-webui-network:  # 声明网络
    driver: bridge
```
这样就可以使用自己的AI啦
![image.png](/static/img/feefc6427c6c722f8414540999354e1d.image.webp)




![image.png](/static/img/ce8f61982a99fb529ef1d094dc1afbb0.image.webp)