Ir al contenido

文档01:基础设施准备(Proxmox & Ubuntu)

在 Proxmox VE 中进行初始资源预配、Ubuntu 服务器配置和稳定 Docker 引擎部署

0阅读

本技术文档规定了在 Proxmox VE 虚拟化环境中部署 Redmine 容器栈前,对基础操作系统Ubuntu Server的配置规范。


在 Proxmox 管理面板中实例化虚拟机时,需配置以下最低资源限制,以避免 Ruby on Rails(Redmine 内置引擎)和 MySQL 数据库引擎导致的性能瓶颈:

  • CPU(处理器):2 个高性能 vCPU(建议在 Proxmox 中配置 Type: host,以启用物理处理器指令的直通)。
  • RAM(内存): 最低 4 GB(Ruby on Rails 在静态资源编译过程中会消耗大量内存)
  • 存储(磁盘): 30 GB SSD(或 NVMe)薄 provisioned(thin provisioning)
  • 操作系统(OS): Ubuntu Server 24.04 LTS 或 22.04 LTS(干净安装)

在完成基础系统安装并建立安全的 SSH 远程访问后,请执行以下更新命令:

Ventana de terminal
# Actualizar base de datos de paquetes y parches del kernel
sudo apt update && sudo apt upgrade -y

安装用于控制台调试和配置编辑的基本工具:

Ventana de terminal
sudo apt install -y curl wget git nano unzip htop

[!IMPORTANT] 禁止通过 snap 或 Ubuntu 默认源安装的 Docker 版本,因为它们缺乏与更新版 Compose V2 插件的直接兼容性。请遵循官方流程:

Ventana de terminal
# 1. Instalar dependencias previas de enrutamiento seguro
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release
# 2. Añadir la llave criptográfica GPG oficial del registro de Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 3. Registrar el repositorio oficial estable en las fuentes de Apt
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 4. Instalar el motor de contenedores y el plugin Compose moderno
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

为避免在与 Docker 套接字交互时持续使用 sudo 命令(降低操作风险并简化自动化),请将系统用户添加到 Docker 引擎组:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] 强制操作步骤:必须退出当前活动终端会话(exit),然后重新登录 SSH 服务器,以重新加载当前用户的令牌权限。


验证服务是否运行正常且用户对本地守护进程拥有完整权限:

Ventana de terminal
docker info
# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso

  • ✓ 已分配资源: 验证 Proxmox 节点中的 CPU、内存和磁盘配置。
  • ✓ 官方 Docker:验证安装通道 stable,避免使用已过时的 snap 版本。
  • ✓ 访问安全: 重新加载控制台会话以操作容器引擎。