openmedicus/hyperfastcgi

hyperfastcgi镜像说明

镜像概述

本镜像基于CentOS 7构建，集成Mono环境与HyperFast CGI 4组件，为ServiceStack webservices提供稳定、轻量的运行环境，支持灵活的部署与配置。

核心功能

• 提供ServiceStack webservices的运行环境
• 支持目录挂载方式部署应用代码
• 允许多容器实例部署实现服务隔离
• 兼容Nginx反向代理与Systemd服务管理

使用场景

• 快速搭建ServiceStack API服务的开发/测试环境
• 生产环境中部署多版本或多路径的ServiceStack服务
• 构建自定义的ServiceStack应用镜像

配置说明

拉取与运行镜像

1. 拉取镜像：

bash
docker pull openmedicus/hyperfastcgi

2. 运行单实例：

bash
docker run --name=servicestack1 -d -v /www/ws1:/var/www:ro -p 9000:9000 hyperfastcgi "/applications=localhost:80:/:/var/www"

该命令将本地/www/ws1目录挂载到容器，运行ServiceStack服务并映射端口9000。

3. 运行多实例（虚拟路径/v2）：

bash
docker run --name=servicestack2 -d -v /www/ws2:/var/www:ro -p 9001:9000 hyperfastcgi "/applications=localhost:80:/:/var/www"

Nginx反向代理配置

先配置端口权限：

bash
semanage port -m -t http_port_t -p tcp 9000

Nginx配置示例：

nginx
upstream fastcgi_backend {
    server 127.0.0.1:9000;
    keepalive 80;
}

upstream fastcgi_backend_v2 {
    server 127.0.0.1:9001;
    keepalive 80;
}

server {
    listen 80;
    server_name 127.0.0.1;
    access_log /var/log/nginx/clinic.log;
    error_log /var/log/nginx/clinic_error.log;

    location ~ /\. { deny all; }

    location / {
        index Global.asax;
        fastcgi_index Global.asax;
        include /etc/nginx/fastcgi_params;
        fastcgi_split_path_info ^((?U).+\.as.x)(/?.+)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        fastcgi_keep_conn on;
        fastcgi_pass fastcgi_backend;
    }

    location /v2 {
        index Global.asax;
        fastcgi_index Global.asax;
        include /etc/nginx/fastcgi_params;
        fastcgi_split_path_info ^(/v2)(/?.*)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        fastcgi_keep_conn on;
        fastcgi_pass fastcgi_backend_v2;
    }
}

Systemd服务管理

创建服务文件/etc/systemd/system/docker-servicestack.service：

ini
[Unit]
Description=ServiceStack Container
Requires=docker.service
After=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker run --name=servicestack1 -v /www/ws1:/var/www:ro -p 9000:9000 docker.io/openmedicus/hyperfastcgi "/applications=localhost:80:/:/var/www"
ExecStop=/usr/bin/docker stop -t 2 servicestack1
ExecStopPost=/usr/bin/docker rm -f servicestack1

[Install]
WantedBy=default.target

启用并启动：

bash
systemctl daemon-reload
systemctl enable docker-servicestack
systemctl start docker-servicestack

构建自定义镜像

Dockerfile示例：

dockerfile
FROM docker.io/openmedicus/hyperfastcgi
MAINTAINER 你的姓名 <你的邮箱@域名.com>

ADD your_ws_folder /var/www/

反馈与交流

如有问题，请访问：https://github.com/openmedicus/HyperFastCgiDocker 留言。