OpenResty Manager 介绍与部署（Docker部署）

news2025/5/16 9:10:07

概述

OpenResty-Manager 是一个基于 OpenResty 构建的开源 Web 管理平台。OpenResty 是一个高性能的 Web 平台，集成了 Nginx 和 LuaJIT，支持强大的脚本功能。OpenResty-Manager 由 Safe3 开发，提供了一个用户友好的界面，用于管理 Nginx 配置、反向代理、SSL 证书等功能，适合需要简化 Web 服务器操作的管理员和开发者。

主要功能

Web 管理界面：通过浏览器直观地配置 Nginx 设置。
反向代理管理：轻松设置和管理上游服务器，支持负载均衡和代理。
SSL 证书管理：支持自动申请（如 Let’s Encrypt）或手动上传证书。
实时监控：跟踪服务器性能、流量和日志。
安全增强：支持配置访问控制，可选的双因子认证（如 OTP）。
Lua 脚本支持：利用 OpenResty 的 LuaJIT 实现自定义逻辑和高级配置。
多协议支持：支持 HTTP、HTTPS、WebSocket 等协议。

主要用途

Web 服务器管理：为非专家用户简化 Nginx 配置。
负载均衡：管理多个后端服务器以实现高可用性。
API 网关：路由和保护 API 流量，提供精细化控制。
内容分发：优化静态和动态内容的分发。
安全管理：强制实施 SSL/TLS 和访问策略。

安装指南

本指南提供在 Ubuntu 22.04 上使用 Docker 安装 OpenResty-Manager 的详细步骤，包括安装最新版 Docker Engine 和 Docker Compose 插件。

前提条件

操作系统：Ubuntu 22.04
权限：具有 sudo 权限的用户
网络：稳定的互联网连接
硬件：至少 1GB 内存，2GB 推荐

安装步骤

1. 安装最新版 Docker 和 Docker Compose 插件

按照以下步骤在 Ubuntu 22.04 上安装 Docker Engine 和 Docker Compose 插件：

更新系统：

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release

添加 Docker 官方 GPG 密钥：

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

添加 Docker 软件源：

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装 Docker Engine 和 Compose 插件：

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

验证安装：

sudo docker --version
docker compose version

确保 Docker 和 Compose 插件已正确安装。

2. 安装 OpenResty-Manager

OpenResty-Manager 提供了 Docker 安装脚本，简化部署过程。

加载预构建镜像（提前加载）：
如果您有 openresty-manager.tar 镜像文件，加载它：
```
sudo docker load -i openresty-manager.tar
```

运行安装脚本：
执行官方提供的 Docker 安装脚本：

sudo bash -c "$(curl -fsSL https://om.uusec.com/docker_installer.sh)"

该脚本会自动下载镜像（如 uusec/openresty-manager）或构建自定义镜像，并配置容器。

管理 OpenResty-Manager：
安装完成后，脚本会显示管理菜单：

=========================
OpenResty Manager Management
=========================
1. Start
2. Stop
3. Restart
4. Upgrade
5. Repair
6. Uninstall
7. Exit

输入 1 启动服务：
```
Please enter the number: 1
```
启动后，服务将运行在 80、443 和 34567 端口。

验证服务：

检查容器状态：
```
sudo docker ps
```
查看日志：
```
sudo docker logs openresty-manager
```

3. 登录管理界面

访问地址：
- 在浏览器中打开：
```
http://<服务器IP>:34567
```
  - 替换 <服务器IP> 为您的服务器公网 IP 或 localhost（本地访问）。
  - 示例：http://192.168.1.100:34567
默认凭证：
- 用户名：admin
- 密码：#Passw0rd
- 注意：密码可能因版本或配置不同而变化，建议参考 Safe3/openresty-manager 文档或 om.uusec.com。

更改默认密码：
- 登录后，导航到“系统设置”或“用户管理”，更改 admin 账户密码以提高安全性。

使用说明

管理菜单操作：
- 启动服务：选择 1（Start）。
- 停止服务：选择 2（Stop）。
- 重启服务：选择 3（Restart）。
- 升级：选择 4（Upgrade），检查并应用最新版本。
- 修复：选择 5（Repair），修复配置或依赖问题。
- 卸载：选择 6（Uninstall），移除 OpenResty-Manager。
- 退出：选择 7（Exit）。
配置反向代理：
- 登录后，在“反向代理”菜单添加上游服务器，设置负载均衡规则。
SSL 证书：
- 在“证书管理”菜单申请 Let’s Encrypt 证书或上传自定义证书。
监控与日志：
- 查看“监控”或“日志”页面，检查服务器状态和访问记录。