dillmann/nginx-ignition

nginx ignition

镜像概述和主要用途

nginx ignition是一款针对nginx Web服务器的用户界面工具，主要面向不想手动管理配置文件的开发者和爱好者。该工具并非追求功能完整性（复杂场景可能仍需手动配置），而是提供一种直观且强大的方式来配置和运行nginx，简化日常管理流程。

核心功能和特性

• 多虚拟主机：支持多个nginx虚拟主机，每个主机可自定义域名、路由和绑定（端口监听）
• 多流代理：支持多个nginx流代理（用于TCP、UDP和Unix套接字流量转发），每个流可自定义绑定和后端服务
• 多样化路由类型：主机路由支持多种模式，包括代理、重定向、执行自定义代码（JavaScript或Lua）、返回静态响应或启用目录列表的静态文件服务
• 服务器配置管理：轻松配置nginx服务器参数，如最大请求体/上传大小、服务器标识、超时设置、日志级别等
• SSL证书管理：支持Let's Encrypt证书（自动续期）、自签名证书及自定义证书
• 日志与自动轮换：提供服务器和虚拟主机的访问日志与错误日志，并支持自动日志轮换
• 多用户访问控制：支持多用户系统，基于属性的访问控制（ABAC）
• 生态集成：原生集成TrueNAS Scale（轻松代理NAS上的应用）和Docker（便捷选择容器作为代理目标）
• 访问列表控制：通过基本认证和/或源IP地址检查，轻松控制资源访问权限

使用场景和适用范围

• 开发者本地开发环境中快速配置nginx代理
• 爱好者搭建个人服务器时简化nginx管理
• 小型部署场景中无需深入nginx配置文件即可完成基础设置
• 需要快速配置虚拟主机、SSL证书或流代理的场景

使用方法和配置说明

快速启动

通过以下命令快速运行nginx ignition（需先安装Docker）：

shell
docker run -p8090:8090 -p80:80 dillmann/nginx-ignition

启动后，在浏览器中访问http://localhost:8090即可开始使用。首次使用无需默认用户名/密码，系统会引导创建管理员账户。

数据库说明

默认配置下，应用使用嵌入式SQLite数据库，适用于测试和实验场景。对于长期使用，建议参考配置文档切换至PostgreSQL数据库。

配置参数

关于可用配置参数及常见用例示例，可参考配置文档（注：实际使用时需替换为具体文档路径或链接）。

故障排除

若遇到应用问题，可参考故障排除文档（注：实际使用时需替换为具体文档路径或链接），包含密码重置等常见恢复操作说明。

贡献与反馈

欢迎通过GitHub提交issue或PR，或通过LinkedIn发送反馈，所有建设性意见均受欢迎。