feat: add more services
This commit is contained in:
62
src/apache/README.md
Normal file
62
src/apache/README.md
Normal file
@@ -0,0 +1,62 @@
|
||||
# Apache HTTP Server
|
||||
|
||||
[English](./README.md) | [中文](./README.zh.md)
|
||||
|
||||
This service deploys Apache HTTP Server, a popular open-source web server.
|
||||
|
||||
## Services
|
||||
|
||||
- `apache`: The Apache HTTP Server service.
|
||||
|
||||
## Environment Variables
|
||||
|
||||
| Variable Name | Description | Default Value |
|
||||
| -------------------------- | ---------------------------------------------- | ------------------- |
|
||||
| APACHE_VERSION | Apache HTTP Server image version | `2.4.62-alpine3.20` |
|
||||
| APACHE_HTTP_PORT_OVERRIDE | Host port mapping for HTTP (maps to port 80) | 80 |
|
||||
| APACHE_HTTPS_PORT_OVERRIDE | Host port mapping for HTTPS (maps to port 443) | 443 |
|
||||
| APACHE_RUN_USER | User to run Apache as | `www-data` |
|
||||
| APACHE_RUN_GROUP | Group to run Apache as | `www-data` |
|
||||
|
||||
Please modify the `.env` file as needed for your use case.
|
||||
|
||||
## Volumes
|
||||
|
||||
- `apache_logs`: A volume for storing Apache logs.
|
||||
- `./htdocs`: Directory for web content (mounted as read-only).
|
||||
- `./httpd.conf`: Optional custom Apache configuration file.
|
||||
- `./ssl`: Optional SSL certificates directory.
|
||||
|
||||
## Usage
|
||||
|
||||
1. Create the service directory structure:
|
||||
|
||||
```bash
|
||||
mkdir -p htdocs
|
||||
```
|
||||
|
||||
2. Add your web content to the `htdocs` directory:
|
||||
|
||||
```bash
|
||||
echo "<h1>Hello World</h1>" > htdocs/index.html
|
||||
```
|
||||
|
||||
3. Start the service:
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
4. Access the web server at `http://localhost` (or your configured port).
|
||||
|
||||
## Configuration
|
||||
|
||||
- Custom Apache configuration can be mounted at `/usr/local/apache2/conf/httpd.conf`
|
||||
- SSL certificates can be mounted at `/usr/local/apache2/conf/ssl/`
|
||||
- Web content should be placed in the `htdocs` directory
|
||||
|
||||
## Security Notes
|
||||
|
||||
- The default configuration runs Apache as the `www-data` user for security
|
||||
- Consider using SSL/TLS certificates for production deployments
|
||||
- Regularly update the Apache version to get security patches
|
||||
Reference in New Issue
Block a user