前后花了快2天时间，研究了一下小龙虾的部署使用，发出来供大家分享！



# 方案一：源码部署
有条件最好还是使用源码进行部署，博主由于是公司服务器不好搞vpn，所以还是先用镜像部署


```
git clone https://github.com/openclaw/openclaw.git

./docker-setup.sh
```

挺简单的，后续配置一起写。

# 方案二：docker镜像部署

## 1、先拉镜像，最新2026.3.8

在我之前推荐的镜像站拉
```
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/ghcr.io/openclaw/openclaw:2026.3.8

docker tag  swr.cn-north-4.myhuaweicloud.com/ddn-k8s/ghcr.io/openclaw/openclaw:2026.3.8  openclaw/openclaw:2026.3.8
```

## 2、编写配置文件

创建数据目录

```
mkdir -p data
```
创建环境配置

```
vim .env
```

文件内容如下：

```
OPENCLAW_IMAGE=openclaw/openclaw:2026.3.8
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_DATA_DIR=./data

```

创建docker-compose.yml


```
vim docker-compose.yml
```
文件内容如下：

```
services:
  # --- 主服务：WebUI 和 Gateway (常驻) ---
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    container_name: openclaw-gateway
    restart: unless-stopped
    init: true
    # 核心改动1：启用宿主机网络模式
    network_mode: host
    environment:
      # 必须配置
      TZ: Asia/Shanghai
      OPENCLAW_GATEWAY_MODE: local
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      # 基础环境
      HOME: /home/node
      TERM: xterm-256color
      # 绑定设置（宿主机模式下建议绑定 0.0.0.0 或保留 lan）
      OPENCLAW_GATEWAY_BIND: "0.0.0.0"
      OPENCLAW_GATEWAY_PORT: 18789
    volumes:
      - ${OPENCLAW_DATA_DIR}:/home/node/.openclaw
      - ${OPENCLAW_DATA_DIR}/workspace:/home/node/.openclaw/workspace
    # 核心改动2：移除 ports 映射（宿主机模式下无需映射）
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "lan",
        "--port",
        "18789",
      ]
    # 补充：添加 root 用户解决权限问题（之前的核心需求）
    user: root
  # --- 工具箱：CLI (默认不启动) ---
  openclaw-cli:
    profiles: ["tools"]
    image: ${OPENCLAW_IMAGE}
    container_name: openclaw-cli
    init: true
    stdin_open: true # -i 允许输入
    tty: true        # -t 伪终端
    # CLI 也启用宿主机网络（保持和主服务一致）
    network_mode: host
    environment:
      OPENCLAW_GATEWAY_MODE: local
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      HOME: /home/node
      TERM: xterm-256color
      BROWSER: echo # 防止尝试打开宿主机浏览器
    volumes:
      - ${OPENCLAW_DATA_DIR}:/home/node/.openclaw
      - ${OPENCLAW_DATA_DIR}/workspace:/home/node/.openclaw/workspace
    entrypoint: ["node", "dist/index.js"]
    # 补充：CLI 也添加 root 用户
    user: root

```

需要注意的几个点：
1. TZ: Asia/Shanghai必须配置，小龙虾web页面连不上很多时候是因为这个时间不一致问题
2. user: root 这个配置也要加，之前进去有时候是node用户，没有修改配置之类的权限

## 3、初始化配置服务
执行如下命令开始初始化

```
docker compose run --rm -u root openclaw-cli onboard
```

一开始无脑点跳过和yes就行，后面有需要再配置

## 5、修改配置


```
vim data/openclaw.json
```

需要改以下内容：


```
 "gateway":
    {
        "port": 18789,
        "mode": "local",
        "bind": "lan",
        "controlUi":
        {
            #OpenClaw 的控制 UI 是网页端，浏览器会做跨域（CORS）验证，设为 true 时，若 UI 端的 Origin 验证失败，会降级使用请求头中的 Host 字段来判断是否允许访问；
            "dangerouslyAllowHostHeaderOriginFallback": true,
            #设为 true 时，允许在非加密通道（HTTP）下传递认证信息；实际情况是这个没卵用
            "allowInsecureAuth": true
        },
        "auth":
        {
            "mode": "token",
            "token": "8406dc0b3bfcffd579314ef9214b7dd66e031f8c1a97b054"
        },
        "tailscale":
        {
            "mode": "off",
            "resetOnExit": false
        },
        "tls":
        {
            #这个是开https的
            "enabled": true,
            "autoGenerate": true
        },
        "nodes":
        {
            "denyCommands":
            [
                "camera.snap",
                "camera.clip",
                "screen.record",
                "contacts.add",
                "calendar.add",
                "reminders.add",
                "sms.send"
            ]
        }
    }
```

## 6、启动服务

```
docker compose up -d
```

页面访问 https:://yourip:18789 即可进入controlUi


# 配置大模型（DashScope）

执行如下命令

```
docker compose run --rm -u root openclaw-cli onboard

```
这一步选择Custom Provider


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

api的接口地址

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

API KEY

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


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

接口协议

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

模型id wen-max或者百炼的其他模型

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

之后就OK了，暂时可以聊天了，之后可以在配置频道

【OpenClaw】小龙虾部署终极方案

https://docker.aityp.com/

好用、爱用！

【Docker】Docker镜像网站推荐

最近要实现个简单的IM系统,打算用ES做全文检索以及历史消息存储，复习下ES的安装以及使用。



# 1、docker-compose安装ES
## 1.1、拉镜像
因为网络问题，官网镜像拉不到，找个合适版本的镜像并安装。

网址：https://docker.aityp.com/r/docker.io/library/elasticsearch


拉ES镜像：
```
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/elasticsearch:8.19.5

docker tag  swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/elasticsearch:8.19.5  elasticsearch:8.19.5
```

拉Kibana镜像

```
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/kibana:8.19.5
docker tag  swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/kibana:8.19.5  kibana:8.19.5
```

下载ik分词器的插件包（ik分词器处理中文全文检索效果最好）并解压好

https://release.infinilabs.com/analysis-ik/stable/

## 1.2、docker-compose配置文件

先修改配置文件

```
echo "vm.max_map_count=262144" >> /etc/sysctl.conf
sysctl -p
```

找个目录创建docker-compose.yml、es-logs、es-data、kibana-config
```
version: '3.8'

services:
  elasticsearch:
    # 构建自定义镜像（代替直接拉取官方镜像）
    build: .  # 表示使用当前目录的 Dockerfile 构建
    container_name: es8
    restart: always
    ports:
      - "9200:9200"
      - "9300:9300"
    environment:
      - discovery.type=single-node
      - cluster.name=es-cluster
      #开启权限验证
      - xpack.security.enabled=true
      - xpack.security.http.ssl.enabled=false
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    volumes:
      - ./es-data:/usr/share/elasticsearch/data
      - ./es-logs:/usr/share/elasticsearch/logs
    networks:
      - es-network

  # 可选：同时启动 Kibana（版本和 ES 一致）
  kibana:
    # Kibana 版本必须和 ES 完全一致！
    image: kibana:8.19.5
    container_name: kibana8
    restart: always
    # 端口映射：5601 是 Kibana 默认端口
    ports:
      - "5601:5601"
    environment:
      # 配置 ES 地址（关键：填 ES 容器名/宿主机IP）
      - ELASTICSEARCH_HOSTS=http://es8:9200  # 若 ES 容器名不是 es8，改为实际名称；也可填宿主机IP：http://192.168.1.100:9200
      # 中文界面（可选）
      - I18N_LOCALE=zh-CN
      # 优化响应超时（避免ES查询慢导致Kibana超时）
      - ELASTICSEARCH_REQUEST_TIMEOUT=30000
    # 挂载配置文件（可选，如需自定义更多配置）
    volumes:
      - ./kibana-config:/usr/share/kibana/config
    # 加入 ES 所在的自定义网络（关键：保证容器互通）
    networks:
      - es-network  # 这个网络名要和 ES 的 docker-compose 中的网络名一致

networks:
  es-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.16.0.0/16
          gateway: 172.16.0.1

volumes:
  es-data:
  es-logs:

```
要注意的点是自定义网络那里，不要和内网已有网段冲突了。


kibana-config目录创建好kibana配置文件kibana.yml
```
server.port: 5601
server.host: "0.0.0.0"  # 允许外部访问
elasticsearch.hosts: ["http://es8:9200"]  # ES地址
#i18n.locale: "zh-CN"  # 中文界面
elasticsearch.requestTimeout: 30000
elasticsearch.username: kibana_system
elasticsearch.password: 123456
# 加密密钥（解决加密报错，必须配置）
xpack.encryptedSavedObjects.encryptionKey: "abcdefghijklmnopqrstuvwxyz1234567890abcd"
```

根目录创建好DockerFile，用于自定义容器

```
FROM elasticsearch:8.19.5

COPY ik /usr/share/elasticsearch/plugins/analysis-ik

# 验证是否复制成功
RUN ls -la /usr/share/elasticsearch/plugins/analysis-ik/

# 暴露端口（和基础镜像一致）
EXPOSE 9200 9300

# 启动命令（和基础镜像一致）
CMD ["elasticsearch"]

```

最终目录结构如下：

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


## 1.3、启动

启动
`docker compose up -d`

停止
`docker compose stop`

重启
`docker compose restart`

查看 ES 日志
`docker compose logs -f elasticsearch`

删除 ES 容器（保留数据卷）
`docker compose down`

删除容器 + 数据卷（谨慎操作，数据会丢失）
`docker compose down -v`

启动后执行
`curl http://localhost:9200`
如果打印如下内容则成功：

```
{
  "name" : "es-node-1",
  "cluster_name" : "es-cluster",
  "cluster_uuid" : "e4dBYZOXSvOWi_KOJ_s4iw",
  "version" : {
    "number" : "8.13.4",
    "build_flavor" : "default",
    "build_type" : "docker",
    "build_hash" : "da95df118650b55a500dcc181889ac35c6d8da7c",
    "build_date" : "2024-05-06T22:04:45.107454559Z",
    "build_snapshot" : false,
    "lucene_version" : "9.10.0",
    "minimum_wire_compatibility_version" : "7.17.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "You Know, for Search"
}
```

## 1.4、配置kibana
进入es容器创建用户，先给默认用户添加密码，这个后续登录用：
```
docker exec -it es8 bash
./bin/elasticsearch-reset-password -u elastic -i
```

kibana默认配置的不能用默认用户，所以创建个新用户给kibana用

```
docker exec -it es8 bash
./bin/elasticsearch-reset-password -u kibana_system  -i
```

重启kibana容器即可

# 2、使用kibana

Kibana 是ELK 技术栈里的可视化工具，专门用来和 Elasticsearch 配合，做日志、指标、数据的查询、展示、分析、监控。访问http://localhost:5601 即可使用kibanna。

先确定几个概念：
- 索引：类似于mysql表的概念，所有的操作都是基于索引做的
- 文档：就是数据，每个索引对应映射的实体数据
- 映射：字段定义，类似mysql的字段

进入kibana界面创建索引

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

创建好之后，进行相关映射的配置，可以使用控制台更方便。

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


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

例如我的消息的表创建索引命令为；

```
PUT /im_message/_mapping?pretty
{
  "properties": {
    "sender_code": {
      "type": "keyword"
    },
    "receiver_code": {
      "type": "keyword"
    },
    "content": {
      "type": "text",
      "analyzer": "ik_max_word"
    },
    "message_time": {
      "type": "date",
      "format": "yyyy-MM-dd HH:mm:ss"
    },
    "read_status": {
      "type": "integer"
    },
    "code": {
      "type": "keyword"
    }
  }
}
```

# 3、SpringBoot引入es并使用

【ES】Elasticsearch的安装与使用

本文教你怎么安装postgis插件



# 1、先更新yum仓库

`vim /etc/yum.repos.d/pgsq-11.repo`


```
[pgdg11-common]
name=PostgreSQL 11 for RHEL / CentOS $releasever - $basearch
baseurl=https://ftp.postgresql.org/pub/repos/yum/common/redhat/rhel-7-x86_64
enabled=1
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-PGDG
[pgdg11]
name=PostgreSQL 11 for RHEL / CentOS $releasever - $basearch
baseurl=https://mirror.pnl.gov/postgresql/pgrpm-11/redhat/rhel-$releasever-$basearch
enabled=1
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-PGDG

```

刷新yum

`yum clean all && yum makecache fast`

# 2、然后安装postgis插件

以pgsql11为例，安装postgis25_11.x86_64最好

`yum install postgis25_11.x86_64`

# 3、执行命令
-- 核心空间扩展（必装）

CREATE EXTENSION IF NOT EXISTS postgis;

结果如图

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

【Pgsql】安装PostGis插件

记录一下多数据源使用以及配置方法和注意事项



# 1、使用方法


```
        
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
            <version>3.6.1</version>
        </dependency>
```

配置文件：

```
spring:
  datasource:
    dynamic:
      primary: master #设置默认的数据源或者数据源组,默认值即为master
      strict: false #设置严格模式,默认false不启动. 启动后在未匹配到指定数据源时候会抛出异常,不启动则使用默认数据源.
      datasource:
        master:
          type: com.zaxxer.hikari.HikariDataSource
          url: jdbc:mysql://xxxx:3306/xx?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC&characterEncoding=UTF8&useSSL=false&allowMultiQueries=true&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true&rewriteBatchedStatements=true
          username: xx
          password: xxxxxxx
          driver-class-name: com.mysql.cj.jdbc.Driver
          hikari:
            max-lifetime: 0
        salve:
          type: com.zaxxer.hikari.HikariDataSource
          driver-class-name: com.mysql.cj.jdbc.Driver
          username: xx
          password: xxxxxx
          url: jdbc:mysql://xxxx:xx/xx?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC&characterEncoding=UTF8&useSSL=false&allowMultiQueries=true&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true&rewriteBatchedStatements=true
          hikari:
            max-lifetime: 1800000
```

# 2、使用

## 1. 标注在Mapper/Service接口上（整个接口使用指定数据源）

```
// 所有该Mapper的方法都使用 "slave" 数据源
@DS("slave")
@Mapper
public interface UserMapper {
    // 查询方法：使用slave数据源
    List<User> listUsers();
    
    // 新增方法：也会使用slave数据源（若需切换可单独注解）
    int insertUser(User user);
}
```
## 2. 标注在Mapper/Service方法上（精准控制单个方法）


```
@Mapper
public interface UserMapper {
    // 查：使用slave数据源
    @DS("slave")
    List<User> listUsers();
    
    // 增：使用master数据源
    @DS("master")
    int insertUser(User user);
}
```

优先级：方法@DS > 类@DS > 全局默认数据源

# 3、注意事项

## 1、避免与事务冲突


- 如果 Mapper 方法被 @Transactional 注解的 Service 方法包裹，数据源切换必须在事务开启前完成；
- 事务内切换数据源不生效（因为事务一旦开启，数据源就固定了），因此建议：
1. 若事务内需要多数据源操作，拆分到不同事务方法；
2. 优先在 Service 层（事务外）标注 @DS，或直接在 Mapper 层标注（确保切换在事务前）。

## 2、数据源名称必须配置正确

## 3、排除扫描问题
确保 Mapper 接口被 Spring 扫描到（通过 @Mapper 或 @MapperScan），否则注解无法被解析。