imthai/pixelserv-tls

pixelserv-tls镜像说明

镜像概述

本镜像提供轻量级的pixelserv-tls web服务器，能够对所有收到的请求返回1px大小的图片，常用于广告拦截等场景。镜像在构建时会自动生成证书，用户可通过指定卷持久化存储证书文件以便备份和复用。

核心功能

1. 对所有HTTP/HTTPS请求返回1px图片
2. 自动生成根证书及动态创建伪造证书
3. 支持证书文件持久化存储到主机目录
4. 提供容器运行时的Shell访问能力

使用场景

• 广告拦截：配合DNS解析工具（如AdGuard Home、Pi-hole），将广告域名指向该服务器，实现广告屏蔽
• 测试环境：模拟简单web服务响应，用于前端或网络测试

配置说明

证书持久化步骤

为方便备份证书，建议将证书文件存储到主机目录：

1. 首次运行容器生成证书：

bash
docker run -d \
 --name pixelserv-tls \
 -p 80:80 -p 443:443 \
 --restart always \
 docker.xuanyuan.run/imthai/pixelserv-tls

（Linux系统推荐使用主机网络模式，替换为--net=host参数）

2. 将容器内证书复制到主机：

bash
docker cp pixelserv-tls:/var/cache/pixelserv/ca.crt .
docker cp pixelserv-tls:/var/cache/pixelserv/ca.key .

3. 删除临时容器：

bash
docker rm -f pixelserv-tls

4. 主机创建专用目录（如~/pixelserv），放入证书文件

5. 卷挂载方式重新运行容器：

bash
docker run -d \
 --name pixelserv-tls \
 -p 80:80 -p 443:443 \
 -v ~/pixelserv:/var/cache/pixelserv \
 --restart always \
 docker.xuanyuan.run/imthai/pixelserv-tls

（Linux系统主机网络模式：）

bash
docker run -d \
 --name pixelserv-tls \
 --net=host \
 -v ~/pixelserv:/var/cache/pixelserv \
 --restart always \
 docker.xuanyuan.run/imthai/pixelserv-tls

容器Shell访问

运行中容器可通过以下命令进入Shell：

bash
docker exec -it pixelserv-tls /bin/sh