managedkaos/cherokee

!https://raw.githubusercontent.com/managedkaos/cherokee/master/img/cherokee-logo.png

Cherokee Web服务器容器

镜像概述

本镜像用于运行Cherokee Web服务器，提供快速部署和管理Web服务的能力。Cherokee是一款高性能、轻量级的Web服务器，支持多种功能扩展，适用于各类Web服务场景。

核心功能与特性

• 内置SSL支持：容器构建时自动创建自签名证书，可直接通过HTTPS访问服务
• 目录映射：支持将本地目录作为卷映射至容器内/var/www目录，用于部署自定义网站内容
• Admin UI支持：提供Cherokee管理界面，可通过命令行启动并进行图形化配置
• 多端口暴露：默认暴露80（HTTP）、443（HTTPS）和9090（管理界面）端口

使用场景

• 快速搭建Cherokee Web服务器进行测试或生产环境部署
• 本地开发时映射项目目录，实时预览网站效果
• 通过管理界面配置服务器参数，如虚拟主机、缓存策略等

使用方法与配置说明

1. 拉取镜像

bash
docker pull managedkaos/cherokee

2. 基本运行容器

bash
docker run --rm --name cherokee -d -p 80:80 -p 443:443 -p 9090:9090 managedkaos/cherokee

3. 验证服务运行

• 访问http://localhost验证HTTP服务
• 访问https://localhost验证HTTPS服务（首次访问需信任自签名证书）

4. 部署本地网站

通过-v参数映射本地目录至容器/var/www，以提供自定义网站内容：

bash
docker run --rm --name cherokee -d -p 80:80 -p 443:443 -p 9090:9090 -v /tmp/www:/var/www managedkaos/cherokee

5. 访问管理界面（Admin UI）

启动管理界面

容器运行后，执行以下命令启动管理界面：

bash
docker exec -it cherokee cherokee-admin -b

获取登录信息

命令执行后，会输出登录凭据和管理界面URL，示例如下：

Cherokee Web Server 1.2.104 (Apr 18 2021): Listening on port ALL:9090, TLS disabled, IPv6 enabled, using epoll, 1048576 fds system limit, max. 524281 connections, caching I/O, 4 threads, 131070 connections per thread, standard scheduling policy

Login:
  User:              admin
  One-time Password: 2C30FKcz2m6npV0z

Web Interface:
  URL:               http://localhost:9090/

登录管理界面

1. 打开浏览器访问http://localhost:9090
2. 输入用户名admin及命令输出的一次性密码进行登录

注意：cherokee-admin命令为交互式命令，会保持shell会话打开，需通过连续按两次CTRL+C结束进程。

注意事项

• 管理界面命令为交互式，关闭会话前需确保已完成配置操作
• 自签名证书仅适用于测试环境，生产环境需替换为可信证书
• 映射本地目录时需确保目录权限正确，避免容器访问文件失败