Meilisearch Ubuntu 完整部署教程（局域网可访问+生产安全+开机自启）

适用：Ubuntu 20.04 / 22.04 / 24.04，目标：局域网所有设备可访问、后台英文界面、中文分词、安全、持久化、开机自启。

一、安装 Meilisearch（官方脚本，最简单）

1. 更新系统 & 安装依赖

sudo apt update && sudo apt upgrade -y
sudo apt install curl ufw -y  # ufw是防火墙

2. 一键安装最新版

curl -L https://install.meilisearch.com | sh

3. 移到系统目录（全局可用）

sudo mv meilisearch /usr/local/bin/

4. 验证安装

meilisearch --version

出现版本号即成功。

二、创建专用用户与数据目录（安全规范）

# 创建系统用户（不能登录）
sudo useradd -r -m -d /var/lib/meilisearch -s /bin/false meilisearch

# 创建数据、快照目录
sudo mkdir -p /var/lib/meilisearch/{data,dumps}
# 授权
sudo chown -R meilisearch:meilisearch /var/lib/meilisearch

三、配置文件（支持中文+局域网+安全）

1. 创建配置文件

sudo mkdir -p /etc/meilisearch
sudo nano /etc/meilisearch/config.toml

2. 粘贴以下配置（直接可用）

# 环境：production 生产模式（强制安全）
env = "production"

# 监听所有网卡（关键：允许局域网访问）
http_addr = "0.0.0.0:7700"

# 数据库路径（持久化）
db_path = "/var/lib/meilisearch/data"

# 快照目录
dump_dir = "/var/lib/meilisearch/dumps"

# 主密钥（必须16位以上，自己改强密码）
master_key = "MyStrongMasterKey_2026"

# 中文分词（内置Jieba，自动生效）
# 无需额外配置，Meilisearch原生支持中文

# 日志
log_level = "info"

3. 保存退出

• nano：Ctrl+O → 回车 → Ctrl+X

四、设置 systemd 服务（开机自启+后台运行）

1. 创建服务文件

sudo nano /etc/systemd/system/meilisearch.service

2. 粘贴内容

[Unit]
Description=Meilisearch Search Engine
After=network.target

[Service]
User=meilisearch
Group=meilisearch
WorkingDirectory=/var/lib/meilisearch
ExecStart=/usr/local/bin/meilisearch --config-file /etc/meilisearch/config.toml
Restart=always  # 崩溃自动重启
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

3. 启用并启动

sudo systemctl daemon-reload
sudo systemctl enable meilisearch
sudo systemctl start meilisearch

4. 查看状态

sudo systemctl status meilisearch

看到 active (running) 即成功。

五、防火墙放行 7700 端口（局域网访问必备）

# 允许7700/tcp
sudo ufw allow 7700/tcp

# 启用防火墙（如果没开）
sudo ufw enable

# 查看规则
sudo ufw status

确保出现：

7700/tcp                   ALLOW       Anywhere

六、获取 Ubuntu 局域网 IP

hostname -I

记下类似：192.168.1.105（你的内网IP）

七、局域网访问（其他电脑/手机）

1. 浏览器访问（英文后台）

http://192.168.1.105:7700

• 输入你配置的 master_key 登录
• 界面全英文，但功能齐全：创建索引、上传文档、搜索测试、设置

2. API 测试（PowerShell/cmd）

# 健康检查
curl http://192.168.1.105:7700/health

# 带密钥查询版本
curl -H "Authorization: Bearer MyStrongMasterKey_2026" http://192.168.1.105:7700/version

八、中文搜索测试（确认可用）

1. 创建索引（如 articles）

curl -X POST -H "Authorization: Bearer MyStrongMasterKey_2026" \
  -H "Content-Type: application/json" \
  http://192.168.1.105:7700/indexes/articles/documents \
  -d '[
    {"id": 1, "title": "Meilisearch中文部署教程", "content": "Ubuntu安装配置"},
    {"id": 2, "title": "局域网访问设置", "content": "防火墙端口开放"}
  ]'

2. 中文搜索

curl -X POST -H "Authorization: Bearer MyStrongMasterKey_2026" \
  -H "Content-Type: application/json" \
  http://192.168.1.105:7700/indexes/articles/search \
  -d '{"q": "中文部署"}'

返回结果即中文分词正常。

九、常用管理命令

# 重启
sudo systemctl restart meilisearch

# 停止
sudo systemctl stop meilisearch

# 查看日志
sudo journalctl -u meilisearch -f

# 修改配置后重启
sudo systemctl restart meilisearch

十、常见问题

1. 连不上

   • 检查 http_addr = 0.0.0.0:7700
   • 防火墙 sudo ufw allow 7700/tcp
   • IP 正确、同网段

2. 权限错误

   • sudo chown -R meilisearch:meilisearch /var/lib/meilisearch

3. 中文搜不到

   • Meilisearch 自动支持中文，无需额外插件
   • 检查文档是否正确导入

十一、总结（最简步骤）

1. 安装：curl ... | sh
2. 配置：http_addr = 0.0.0.0:7700 + master_key
3. 服务：systemd 开机自启
4. 防火墙：放行 7700
5. 访问：http://内网IP:7700