ahmet2mir/reverseproxy

Docker反向代理镜像

镜像概述

本镜像基于Nginx实现反向代理功能，支持根路径和子路径（如https://mydomain/mypath）的代理转发，兼容HTTP和HTTPS协议，适用于Docker 1.3及以上版本，可通过docker exec命令管理配置。

核心功能

• 支持根路径与子路径反向代理
• HTTP/HTTPS协议切换
• 自定义SSL证书挂载
• 域名添加/删除管理
• 路径映射配置（含根路径）
• Nginx配置重载
• 日志持久化存储

使用场景

• 多Web服务统一域名入口管理（如不同应用通过同一域名的不同子路径访问）
• Docker环境下服务的HTTPS加密访问配置
• 跨容器服务的路由转发与流量管理

配置说明

基础部署

启动反向代理容器（支持80/443端口）：

bash
docker run --name reverseproxy -d -p 443:443 ahmet2mir/reverseproxy
# 或同时暴露80端口
docker run --name reverseproxy -d -p 80:80 -p 443:443 ahmet2mir/reverseproxy

自定义SSL证书

挂载本地SSL证书目录：

bash
docker run --name reverseproxy -d -p 443:443 -v /本地SSL路径:/webapps/ssl ahmet2mir/reverseproxy

将<domain>.crt和<domain>.key放入本地SSL路径，证书更新后需重载Nginx。

日志持久化

挂载日志目录：

bash
docker run --name reverseproxy -d -p 443:443 -v /本地SSL路径:/webapps/ssl -v /本地日志路径:/webapps/logs ahmet2mir/reverseproxy

域名与路径管理

• 添加域名：

  bash
  docker exec reverseproxy domain -a --hostname myserver.lan
  

• 删除域名：

  bash
  docker exec reverseproxy domain -d --hostname myserver.lan
  

• 添加子路径代理：

  bash
  docker exec reverseproxy path -a --hostname myserver.lan --ip_address 172.17.0.231 --port 5984 --protocol http --path couchdb
  

• 添加根路径代理（_root为保留关键词）：

  bash
  docker exec reverseproxy path -a --hostname myserver.lan --ip_address 172.17.0.231 --port 80 --protocol http --path _root
  

• 删除路径：

  bash
  docker exec reverseproxy path -d --hostname myserver.lan --path _root
  

• 重载Nginx配置：

  bash
  docker exec reverseproxy nginx -s reload
  

完整示例（多服务代理）

1. 启动反向代理及目标服务：

   bash
   docker run --name reverseproxy -d -p 443:443 ahmet2mir/reverseproxy
   docker run --name shaarli -d ahmet2mir/shaarli
   docker run --name blogotext -d ahmet2mir/blogotext
   docker run --name couchdb -d fedora/couchdb
   

2. 添加域名：

   bash
   docker exec reverseproxy domain -a --hostname myserver.lan
   

3. 获取服务IP并配置路径：
   • Blogotext（根路径）：

     bash
     BLOG_IP=$(docker inspect --format='{{.NetworkSettings.IPAddress}}' blogotext)
     docker exec reverseproxy path -a --hostname myserver.lan --ip_address $BLOG_IP --port 80 --protocol http --path _root
     

   • Shaarli（子路径shaarli）：

     bash
     SHAARLI_IP=$(docker inspect --format='{{.NetworkSettings.IPAddress}}' shaarli)
     docker exec reverseproxy path -a --hostname myserver.lan --ip_address $SHAARLI_IP --port 80 --protocol http --path shaarli
     

   • CouchDB（子路径couchdb）：

     bash
     COUCHDB_IP=$(docker inspect --format='{{.NetworkSettings.IPAddress}}' couchdb)
     docker exec reverseproxy path -a --hostname myserver.lan --ip_address $COUCHDB_IP --port 5984 --protocol http --path couchdb
     

4. 访问服务：
   • Blog：https://myserver.lan/
   • Shaarli：https://myserver.lan/shaarli/
   • CouchDB：https://myserver.lan/couchdb/

数据备份

镜像数据存储于/webapps/目录，包含：

• cache：缓存数据
• conf：Nginx配置与模板
• sites：已启用的站点配置
• scripts：管理脚本（path.sh/domain.sh）
• logs：日志文件
• ssl：SSL证书

自定义配置

提前准备配置目录并挂载：

bash
# 创建本地目录
mkdir -p /my/webapps/{cache,conf,sites,scripts,logs,ssl}
# 复制配置文件（需先克隆仓库）
git clone https://github.com/ahmet2mir/dockerfiles
cp dockerfiles/reverseproxy/assets/conf/* /my/webapps/conf/
cp dockerfiles/reverseproxy/assets/scripts/* /my/webapps/scripts/
# 启动容器并挂载目录
docker run --name reverseproxy -d -p 443:443 -v /my/webapps:/webapps ahmet2mir/reverseproxy

许可证

Apache 2.0许可证（详见Apache License）