Skip to content

宝塔面板安装ReMan指南

本文介绍如何通过宝塔面板安装ReMan。建议同时参考 完整安装指南 获得更详细的技术细节。

📺 视频教程https://www.bilibili.com/video/BV1aE2AYHEuq/

重要说明

安装方式对比

我们强烈推荐使用干净环境和 docker compose 来部署所需服务。

如果坚持使用宝塔面板,请:

  1. 仔细阅读所有ReMan文档
  2. 理解技术原理后再操作
  3. 具备基础的Linux和Docker知识

安装架构差异

服务推荐方式宝塔方式
MySQLDocker Compose宝塔安装
RedisDocker Compose宝塔安装
ElasticsearchDocker ComposeDocker安装(宝塔版本不兼容)
ReMan二进制部署二进制部署

目录结构说明

txt
/root/                    # 家目录(root用户)
├── env/                  # 第三方服务配置
└── app/                  # ReMan程序目录
    ├── reman            # 可执行文件
    └── config.yml       # 配置文件

💡 提示~ 符号代表家目录,root用户为 /root,普通用户为 /home/用户名

系统要求

  • 最低配置:2核4G内存
  • 推荐系统:Ubuntu 22.04
  • 推荐服务器:雨云香港服务器 -> https://www.rainyun.com

准备资源

下载必需文件

  1. 组件包https://wwhb.lanzn.com/iLyLF2qj0adg
  2. ReMan程序https://github.com/Xwudao/reman-release

第一步:安装宝塔面板

安装命令

sh
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh ed8484bec

安装基础软件

登录宝塔Web面板后,安装以下软件:

  1. MySQL - 数据库服务 MySQL安装

  2. Nginx - Web服务器

  3. Redis - 缓存服务 Redis安装

  4. Docker - 容器服务(用于Elasticsearch) Docker安装

⚠️ 注意:宝塔的Elasticsearch是8.x版本,与ReMan不兼容,必须用Docker安装7.x版本

第二步:上传和解压文件

文件上传

  1. 进入宝塔文件管理器

  2. 导航到家目录(通常是 /root家目录导航

  3. 上传以下文件:

    • reman-install.zip(组件包)
    • linux_amd64.zip(ReMan程序) 文件上传

创建目录结构

通过宝塔终端或SSH执行:

sh
# 创建目录
mkdir ~/env ~/app

# 移动文件到对应目录
mv reman-install.zip ~/env/
mv linux_amd64_v*.zip ~/app/  # 根据实际文件名调整

第三步:部署Elasticsearch

解压和配置

sh
# 解压组件包
cd ~/env
sudo apt install unzip  # 如果未安装
unzip reman-install.zip

# 修改docker-compose.yml,只保留Elasticsearch配置

编辑docker-compose.yml

删除MySQL和Redis配置,只保留:

yml
version: '3'

services:
  elasticsearch:
    image: elasticsearch:7.17.7
    restart: always
    hostname: es1
    container_name: elasticsearch
    volumes:
     - ./es-data:/var/lib/elasticsearch/data
     - ./plugins:/usr/share/elasticsearch/plugins
     - ./elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml
    environment:
     - "ES_JAVA_OPTS=-Xms1200m -Xmx1200m"
     - discovery.type=single-node
    ports:
      - '127.0.0.1:9200:9200'
    privileged: true

启动Elasticsearch

sh
cd ~/env

# 测试启动(前台运行)
sudo docker compose up

# 无错误后,后台启动
sudo docker compose up -d

ES部署成功

第四步:解压ReMan程序

sh
cd ~/app

# 解压ReMan程序
unzip linux_amd64_v*.zip

# 重命名并设置权限
mv reman_linux_amd64_v* reman
chmod +x reman

第五步:创建网站和数据库

新建站点

在宝塔面板中创建新站点:

新建站点

创建站点的目的

  1. 提供域名访问入口
  2. 自动创建MySQL数据库
  3. 配置反向代理

配置反向代理

  1. 进入站点设置 站点设置

  2. 添加反向代理 反向代理配置

  3. 配置代理参数:

    • 代理名称:reman
    • 目标URLhttp://127.0.0.1:4677
    • 发送域名$host

    代理详细配置

HTTPS证书注意事项

如果反向代理影响SSL证书申请:

  1. 临时关闭反向代理
  2. 申请SSL证书
  3. 重新开启反向代理

第六步:配置和启动ReMan

配置文件修改

编辑 ~/app/config.yml,参考 完整安装指南的配置部分

关键配置项

yml
# 数据库配置(使用宝塔创建的数据库信息)
db:
  database: 宝塔创建的数据库名
  host: 127.0.0.1
  username: 数据库用户名
  password: 数据库密码
  port: 3306

# Redis配置(宝塔Redis默认配置)
redis:
  addr: 127.0.0.1:6379
  db: 0
  password: ''

# 其他配置项参考完整安装指南

启动ReMan

sh
cd ~/app

# 首次启动测试
./reman

# 记录管理员账号信息后,按Ctrl+C退出
# 然后使用PM2管理(参考完整安装指南)

后续步骤

完成以上配置后,继续参考 完整安装指南 完成:

  1. PM2进程管理
  2. 系统监控配置
  3. 日常维护

故障排除

常见问题

  1. 端口冲突:检查4677端口是否被占用
  2. 数据库连接:确认宝塔MySQL服务正常运行
  3. Redis连接:检查宝塔Redis服务状态
  4. ES连接:确认Docker容器正常运行

检查命令

sh
# 检查服务状态
sudo docker ps                    # Docker容器状态
netstat -tulpn | grep 4677       # ReMan端口状态
pm2 ls                           # PM2进程状态

# 查看日志
pm2 logs reman                   # ReMan日志
sudo docker logs elasticsearch   # ES日志

关闭防火墙

建议服务器仅开放:2280443端口,其他端口都关闭。

ReMan 目前依赖的服务涉及的端口如下 :3306637992004677930080443

其中,特别是 3306637992009300 这几个端口,是必须关闭的,这涉及到数据安全问题,不然容易被别人连接。

特别强调: 不要信任宝塔的防火墙功能,请务必在服务器商提供的后台进行防火墙设置,宝塔的功能基于系统,但是某些厂商的提供的系统有问题。

特别强调: 不要信任宝塔的防火墙功能,请务必在服务器商提供的后台进行防火墙设置,宝塔的功能基于系统,但是某些厂商的提供的系统有问题。

特别强调: 不要信任宝塔的防火墙功能,请务必在服务器商提供的后台进行防火墙设置,宝塔的功能基于系统,但是某些厂商的提供的系统有问题。

雨云防火墙参考:

宝塔防火墙