woahbase/alpine-ssh

alpine-ssh

镜像概述

alpine-ssh是一个多架构Docker镜像，基于轻量级Alpine Linux构建，集成了S6进程管理系统、SSH/SSL服务、RSync文件同步工具和TMux终端复用器。该镜像旨在提供一个精简、高效且跨平台的基础环境，适用于需要远程访问、进程管理和文件同步的场景。

核心功能与特性

多架构支持

• 支持多种硬件架构，包括：x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等，可在不同平台设备上运行。

轻量级基础

• 基于Alpine Linux，具备体积小（各架构镜像大小均保持在轻量化水平）、启动快、资源占用低的特点。

进程管理

• 集成S6进程管理系统，提供可靠的进程监控与管理能力，确保服务稳定运行。

远程访问与安全

• 内置SSH/SSL服务，支持安全的远程登录与加密通信，满足远程管理需求。

文件同步

• 包含RSync工具，支持本地与远程主机间的文件同步，适用于数据备份与传输场景。

终端复用

• 集成TMux终端复用器，支持多窗口、会话管理，提升远程终端操作效率。

使用场景与适用范围

• 轻量级远程服务器：作为资源受限环境（如嵌入式设备、边缘计算节点）的SSH服务器。
• 跨架构开发/测试环境：在不同架构设备上提供一致的基础操作环境。
• 文件同步服务：利用RSync实现本地与容器间或容器间的文件同步与备份。
• 多任务终端管理：通过TMux在单个SSH会话中管理多个终端任务，提高工作效率。
• 自动化运维节点：作为自动化脚本执行或监控代理的基础环境。

使用方法与配置说明

基本运行命令

通过以下命令启动容器，默认映射SSH端口22到主机：

bash
docker run -d --name alpine-ssh -p 2222:22 woahbase/alpine-ssh

环境变量配置

可通过环境变量自定义容器配置（根据镜像常规SSH服务配置推测）：

• SSH_ROOT_PASSWORD：设置root用户SSH登录密码（建议优先使用密钥认证）
• SSH_AUTHORIZED_KEYS：添加SSH公钥，格式为多行公钥文本，用于免密登录
• TZ：设置时区，如Asia/Shanghai

示例（使用密钥认证）：

bash
docker run -d --name alpine-ssh \
  -p 2222:22 \
  -e SSH_AUTHORIZED_KEYS="ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..." \
  woahbase/alpine-ssh

持久化配置

挂载本地目录以持久化SSH配置和数据：

bash
docker run -d --name alpine-ssh \
  -p 2222:22 \
  -v /host/path/ssh-config:/etc/ssh \
  -v /host/path/data:/data \
  woahbase/alpine-ssh

docker-compose配置示例

yaml
version: '3'
services:
  alpine-ssh:
    image: woahbase/alpine-ssh
    container_name: alpine-ssh
    ports:
      - "2222:22"
    environment:
      - TZ=Asia/Shanghai
      - SSH_AUTHORIZED_KEYS=ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...
    volumes:
      - ./ssh-config:/etc/ssh
      - ./data:/data
    restart: unless-stopped

远程访问示例

启动容器后，通过SSH客户端连接（默认用户为root）：

bash
ssh root@localhost -p 2222

若配置了密钥认证，无需输入密码即可登录；若使用密码认证，输入SSH_ROOT_PASSWORD环境变量设置的密码。

维护与支持

该镜像由WOAHBase维护，更多详细文档与更新信息可参考官方资源。