quesdev/barebone

Ubuntu 20.04 集成环境镜像文档

镜像概述

本镜像基于Ubuntu 20.04 LTS构建，集成常用系统工具、Nginx最新版及Node.js 20.x，提供开箱即用的开发、测试与运行环境，简化Web应用开发、服务部署流程，减少环境配置成本。

核心功能与特性

基础系统与工具

• 系统版本：Ubuntu 20.04 LTS（长期支持版，稳定性高，兼容性好）
• 预装工具集：
  • 文本编辑：vim（增强文本编辑器，支持语法高亮与扩展）
  • 版本控制：git（分布式代码管理工具，支持分支管理与协作）
  • 网络工具：curl（命令行HTTP客户端，支持文件传输与API测试）
  • 系统依赖：libaio1（异步I/O库，支持高性能I/O操作）
  • 编译工具：build-essential（含gcc、g++、make等，支持源码编译）
  • 配置工具：gettext-base（提供envsubst等环境变量替换工具，便于配置文件动态生成）

Nginx服务

• 版本：latest（最新稳定版，包含安全更新与性能优化）
• 核心特性：支持HTTP/HTTPS、反向代理、负载均衡、静态资源服务，配置文件路径为/etc/nginx/，默认监听80端口。

Node.js环境

• 版本：Node.js 20.x（LTS版本，支持ES6+语法、模块化开发，含npm包管理器）
• 核心特性：支持异步I/O、事件驱动架构，兼容主流Node.js生态（如Express、React等框架）。

使用场景

• Web应用开发：前端/后端一体化开发环境，支持Node.js应用调试与Nginx反向代理配置
• 服务部署：快速部署基于Node.js的API服务或Nginx静态资源服务
• 临时开发环境：无需本地配置，直接启动容器进行代码编写、编译与测试
• CI/CD节点：作为持续集成/部署流程中的执行环境，完成代码拉取、依赖安装、构建打包等操作

使用方法与配置说明

基本启动命令

后台运行（默认启动bash）

bash
docker run -d --name ubuntu-env docker.xuanyuan.run/my-image:latest

交互式操作（进入容器终端）

bash
docker run -it --name ubuntu-dev docker.xuanyuan.run/my-image:latest /bin/bash

端口映射（暴露Nginx/Node.js服务端口）

bash
# 映射Nginx默认80端口与Node.js应用3000端口
docker run -d -p 80:80 -p 3000:3000 --name web-service docker.xuanyuan.run/my-image:latest

Nginx服务管理

启动/停止/重启Nginx

bash
# 进入容器
docker exec -it [容器ID/名称] /bin/bash

# 启动Nginx
service nginx start

# 停止Nginx
service nginx stop

# 重启Nginx（配置更新后生效）
service nginx restart

自定义Nginx配置

通过挂载本地配置文件覆盖默认配置：

bash
# 挂载自定义nginx.conf
docker run -d -p 80:80 -v /local/path/nginx.conf:/etc/nginx/nginx.conf docker.xuanyuan.run/my-image:latest

# 挂载虚拟主机配置（如default.conf）
docker run -d -p 80:80 -v /local/path/default.conf:/etc/nginx/sites-available/default docker.xuanyuan.run/my-image:latest

Node.js环境使用

查看版本信息

bash
docker exec -it [容器ID/名称] node -v  # 输出 Node.js 版本（如 v20.12.0）
docker exec -it [容器ID/名称] npm -v   # 输出 npm 版本（如 10.5.0）

运行Node.js应用示例

1. 创建简单HTTP服务（容器内操作）：

bash
# 进入容器
docker exec -it [容器ID/名称] /bin/bash

# 创建应用文件
cat > app.js << 'EOF'
const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Node.js Service Running\n');
});
server.listen(3000, () => {
  console.log('Server running on port 3000');
});
EOF

# 启动服务（后台运行）
node app.js &

2. 通过宿主机访问（需提前映射3000端口）：

bash
curl http://localhost:3000  # 输出 "Node.js Service Running"

数据持久化配置

通过-v参数挂载宿主机目录，实现代码、日志等数据持久化：

bash
# 挂载应用代码目录与Nginx日志目录
docker run -d -p 80:80 -p 3000:3000 \
  -v /local/app:/app \          # 宿主机代码目录映射至容器/app
  -v /local/nginx-logs:/var/log/nginx \  # Nginx日志持久化
  --name persistent-env my-image:latest

注意事项

• 服务自启：容器默认未配置服务自启（Nginx/Node.js需手动启动），生产环境建议通过supervisord或启动脚本（如/entrypoint.sh）管理服务生命周期
• 权限控制：默认以非root用户运行，修改系统配置或绑定特权端口（<1024）时需添加--user root参数（谨慎使用，避免安全风险）
• 镜像更新：定期拉取最新镜像以获取安全补丁与工具版本更新