快速部署

面向站点运营方 · 安装包 lingmeng-x.x.x.zip · 推荐 2 核 4G 及以上 · 按顺序执行，不要跳步

1

云服务器CentOS 7+ / Ubuntu 20.04+ 推荐 2 核 4G

宝塔面板已安装并可登录

安装包lingmeng-x.x.x.zip

域名（生产）已备案，用于 HTTPS、微信回调

2

Go最新稳定版 终端 go version 确认

MySQL8.0+

Redis6.0+

Nginx任意稳定版

ffmpeg + ffprobe系统 PATH 可执行 视频封面、整段视频水印需要二者都在；仅图片水印不需要

• 安全中放行 80、443；不要对公网开放 8080
• 可选：Meilisearch、Gorse 见可选基础设施文档
• 宝塔软件商店里的「FFmpeg 管理器」有时只装 ffmpeg、不带 ffprobe，或不在系统 PATH — 灵萌后台检测会报 ffprobe 未检测到
• 推荐直接用下方终端命令安装完整 ffmpeg 包（通常 ffmpeg 与 ffprobe 同目录一并提供）
• 装好后：管理后台 → 系统设置 → 视频水印 →「服务端媒体依赖」→ 重新检测，两项均应显示已安装

宝塔 → 终端：安装 ffmpeg（含 ffprobe，按系统选一条）

# 不推荐仅依赖软件商店「FFmpeg 管理器」—— 常见只有 ffmpeg、缺 ffprobe 或未加入 PATH

# 推荐：宝塔 → 终端，按系统选一条执行（会同时安装 ffmpeg 与 ffprobe）

# Ubuntu / Debian
apt update && apt install -y ffmpeg

# CentOS 7
yum install -y epel-release
yum install -y ffmpeg

# CentOS 8+ / Rocky / AlmaLinux
dnf install -y epel-release
dnf install -y ffmpeg --allowerasing

# 验证（两条都要有版本输出）
ffmpeg -version
ffprobe -version

# 若 ffmpeg 有、ffprobe 无：先看是否同目录（宝塔插件常见）
dirname $(which ffmpeg)
ls -l $(dirname $(which ffmpeg))/ffprobe

# 同目录有 ffprobe 但未进 PATH 时，可建软链（路径按上一步实际输出替换）
# ln -sf /usr/bin/ffprobe /usr/local/bin/ffprobe

# 仍无 ffprobe：卸载宝塔 FFmpeg 插件后，改用上方 apt/yum/dnf 重装完整包

若只需图片水印、不上传视频封面/整段视频水印，可暂不装 ffmpeg；涉及视频能力则 ffmpeg 与 ffprobe 缺一不可。

可选基础设施 →视频水印与服务端检测 →

3

MySQL 版本8.0 及以上 低于 8.0 可能导致迁移或 SQL 兼容问题

数据库名lingmengv2（自定）

访问权限本地服务器

• 记下库名、用户名、密码，初始化向导中会用到

4

• 宝塔 → 文件 → 进入 /www/wwwroot/，新建文件夹 lingmeng
• 将 lingmeng-x.x.x.zip 上传到 /www/wwwroot/lingmeng/
• 在宝塔文件管理中选中 zip → 解压，解压后目录内应有 lingmeng 可执行文件

宝塔 → 终端：赋予可执行权限

chmod +x /www/wwwroot/lingmeng/lingmeng

运行后会在同目录生成 config.yaml、logs/、uploads/，须保证 www 用户可写

5

按图填写：执行文件与启动命令均为 /www/wwwroot/lingmeng/lingmeng，端口 8080，运行用户 www，勾选放行端口与开机启动

项目执行文件/www/wwwroot/lingmeng/lingmeng

项目名称 / 备注lingmeng

项目端口8080 勾选「放行端口」

执行命令/www/wwwroot/lingmeng/lingmeng

环境变量无

运行用户www

开机启动勾选 自带守护，每 120 秒检测一次

• 宝塔 → 网站 → 选择「Go 项目」→ 添加项目
• 绑定域名：填正式域名（或先填 IP:8080 测试，生产务必改 HTTPS 域名）
• 生产环境可在站点设置中申请 SSL 并开启强制 HTTPS
• 若域名走 CDN（如腾讯云边缘安全加速 EdgeOne），须在 CDN 控制台开启 WebSocket，否则 /ws 无法连接、消息/私聊会异常
• HTTPS 站点须在 config.yaml（或初始化向导 CORS）的 allowed_origins 中写入 https:// 域名，仅写 http:// 会导致 /ws 403，详见 WebSocket 连接排查文档

CDN 默认可能不转发 WebSocket，接入 EdgeOne 等加速服务后务必手动开启 WS 并验证消息功能。

6

宝塔软件商店中的「进程守护管理器」，安装后在此添加守护进程

运行目录/www/wwwroot/lingmeng

启动命令/www/wwwroot/lingmeng/lingmeng

进程数量1

• 宝塔 → 网站 → Go 项目 → 找到上一步添加的站点 → 停止/关闭（避免与进程守护重复占用 8080）
• 软件商店搜索「进程守护管理器」并安装（如图）
• 添加守护进程并启动，首次运行会生成 config.yaml，setup_completed 应为 false
• 8080 仅本机可访问，对外仍通过第 5 步绑定的域名访问

7

• 填写端口 8080、网站地址（与宝塔站点一致）
• MySQL、Redis 连接信息 → 测试连接
• 生成登录密钥 → 确认安装 → 重启进程

初始化向导详解 →

8

进入管理后台 →

9

1系统设置 → 网站信息文档

2系统配置 → 文件存储文档

3系统配置 → 微信小程序/公众号文档

4区域管理 → 区域列表文档

5区域管理 → 用户配置文档

6UI管理 → 页面配置文档

7UI管理 → TabBar配置文档

8上线检查清单文档

10

后端进程进程守护状态为运行中

API 存活/api/health 或系统监控

WebSocket私聊/消息可连接；走 CDN 时已开启 WS

管理后台能登录、能保存系统配置

文件上传网站信息里上传 Logo 成功

常见问题

进程启动后立即退出检查执行权限、logs/ 日志、8080 端口占用

站点无法访问或 502Go 项目是否运行中、端口是否为 8080、lingmeng 进程与 logs/ 日志

无法访问 /setupsetup_completed 已为 true 不可重复；检查域名与 HTTPS

消息一直连接中、发不出若域名接了 CDN（如腾讯 EdgeOne），须在 CDN 控制台开启 WebSocket；检查 Nginx 反代 Upgrade 头；HTTPS 站点 CORS 白名单须含 https:// Origin（见 /ops/websocket）

更新版本停止服务 → 备份 config.yaml 与数据库 → 覆盖二进制 → 启动

默认账号

admin / admin123必须改密码

下一步

初始化向导详解功能模块总览系统配置总览上线检查清单