moodlehq/moodlenet_mock

MoodleNet Mock服务器

这是一个容器化的MoodleNet实例模拟工具，专为测试目的设计。该模拟服务器必须使用HTTPS协议，支持本地TLS（主机到容器）和容器化TLS（容器到容器）两种模式。证书需在容器外部生成，并通过Docker卷挂载到运行中的容器中，适用于本地开发和Docker Compose环境。

核心功能

• 模拟MoodleNet实例，满足测试需求
• 支持HTTPS协议，兼容两种TLS通信模式
• 允许外部生成证书并通过卷挂载
• 适配本地开发和容器化环境场景

使用场景

• 本地开发中测试与MoodleNet集成的应用
• 容器化环境下（如Docker Compose）验证服务间TLS通信
• 非Docker方式运行Symfony应用进行调试（如启用Xdebug）

配置说明

本地开发设置（主机到容器TLS）

1. 获取https://github.com/FiloSottile/mkcert%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%88%9B%E5%BB%BA%E5%BC%80%E5%8F%91%E8%AF%81%E4%B9%A6%E3%80%82
2. 在/etc/hosts文件中配置测试主机（如'moodlenet.test'）：

   127.0.0.1 localhost moodlenet.test
   

3. 为指定主机（及localhost）启用TLS并构建容器：

   ./build.sh localhost moodlenet.test
   

4. 运行容器（构建过程结束时会输出该命令）：

   docker run -di -p 443:443 -v "$(pwd)/certs":/opt/ssl/certs docker.xuanyuan.run/moodlenet-mock
   

5. 通过https://moodlenet.test访问模拟服务器。

完全容器化开发设置（容器到容器TLS）

1. 在主机目录生成证书（可使用mkcert、openssl等工具），需包含以下文件：
   • ca.crt（根证书，如certs/ca.crt）
   • moodlenet.p12（包含相关主机证书和密钥的PKCS12存储，如certs/moodlenet.p12）
2. 构建容器：

   docker build -t moodlenet-mock:latest .
   

3. 运行容器并挂载证书（根据实际证书目录调整）：

   docker run -p 443:443 -v "$(pwd)/certs":/opt/ssl/certs docker.xuanyuan.run/moodlenet-mock
   

本地运行Symfony应用（非Docker方式）

该方式适用于调试（容器未配置Xdebug），仅使用构建脚本生成证书：

1. 启用TLS构建（生成Symfony CLI所需证书，只需运行一次）：

   ./build.sh localhost moodlenet.test
   

2. 进入应用目录：

   cd app
   

3. 检查环境要求：

   symfony check:requirements
   

4. 安装依赖：

   composer install
   

5. 启动应用：

   symfony server:start --port=8080 --p12=../certs/moodlenet.p12