mirror of https://github.com/SeanChang/xuanyuan_docker_proxy.git synced 2026-10-07 16:08:23 +08:00

Files

T

新增镜像中文简介

2026-07-13 00:37:24 +08:00

12 KiB

Raw Permalink Blame History

image, description, source, canonical, exported_at

image	description	source	canonical	exported_at
linuxserver/openssh-server	提供OpenSSH服务器服务，支持远程登录与服务器管理，具备易于部署、配置灵活的特点，适用于各类需要安全远程访问的场景。	https://xuanyuan.cloud/zh/r/linuxserver/openssh-server	https://xuanyuan.cloud/zh/r/linuxserver/openssh-server	2026-07-12T16:36:12.930Z

轩辕镜像中文简介（在线版）： linuxserver/openssh-server 中文简介

含镜像标签、拉取命令、部署文档与相关推荐。

linuxserver/openssh-server

镜像概述和主要用途

OpenSSH Server 镜像是一个沙箱环境，允许通过 SSH 访问而无需授予对整个服务器的密钥权限。通常，通过私钥授予 SSH 访问意味着给予服务器的完全访问权限，而此容器创建了一个受限的沙箱环境，用户只能访问映射的文件夹和容器内运行的进程。

该镜像由 LinuxServer.io 团队维护，提供定期更新、安全加固和简化的用户权限管理，适用于需要安全隔离 SSH 访问的场景。

核心功能和特性

LinuxServer.io 通用特性

定期及时的应用更新
简单的用户映射（PGID、PUID）
基于 s6 overlay 的自定义基础镜像
每周基础 OS 更新，跨整个 LinuxServer.io 生态系统共享通用层，以最小化空间占用、 downtime 和带宽消耗
定期安全更新

OpenSSH Server 特定功能

支持通过环境变量自动配置公钥（PUBLIC_KEY、PUBLIC_KEY_FILE、PUBLIC_KEY_DIR、PUBLIC_KEY_URL）
可选密码访问控制（PASSWORD_ACCESS）
细粒度 sudo 权限管理（SUDO_ACCESS），支持密码或密码less sudo
多架构支持（x86-64、arm64）
日志重定向至标准输出（LOG_STDOUT）
自定义用户名称（USER_NAME）
集成密钥生成辅助脚本

支持的架构

该镜像通过 Docker manifest 实现多平台支持，拉取 lscr.io/linuxserver/openssh-server:latest 即可自动获取对应架构的镜像，也可通过标签指定特定架构：

架构	支持情况	标签
x86-64	✅	amd64-<version tag>
arm64	✅	arm64v8-<version tag>

使用场景和适用范围

安全隔离的 SSH 访问：为第三方或自动化流程提供受限 SSH 访问，仅允许访问特定映射目录
备份服务器：允许远程服务器通过 SSH 上传备份文件，限制访问范围至备份目录
多实例隔离：通过不同端口和卷映射运行多个容器，实现不同用户/服务的访问隔离
自动化运维：为 CI/CD 流程提供受限 SSH 访问，执行特定操作（如文件传输、命令执行）

使用方法和配置说明

应用设置

公钥配置

若设置 PUBLIC_KEY、PUBLIC_KEY_FILE 或 PUBLIC_KEY_DIR 环境变量，指定的公钥将自动添加至 authorized_keys
未设置上述变量时，需手动将公钥添加至 /config/.ssh/authorized_keys 并重启容器
移除公钥相关环境变量不会从 authorized_keys 中删除已添加的密钥
PUBLIC_KEY_FILE 和 PUBLIC_KEY_DIR 支持 Docker secrets

密码访问（不推荐用于公网环境）

通过 PASSWORD_ACCESS=true 启用密码访问，需同时设置 USER_PASSWORD 或 USER_PASSWORD_FILE

连接方式

ssh -i /path/to/private/key -p <映射端口> <用户名>@<服务器IP>

Sudo 权限

设置 SUDO_ACCESS=true 允许 sudo 访问，未设置 USER_PASSWORD 时为密码less sudo
USER_PASSWORD 或 USER_PASSWORD_FILE 用于设置 sudo 密码

自定义配置

通过卷映射 /etc/motd 自定义登录欢迎信息
通过 --hostname 参数设置容器主机名

密钥生成

容器提供密钥生成辅助脚本，运行以下命令生成 SSH 公私钥对：

docker run --rm -it --entrypoint /keygen.sh docker.xuanyuan.run/linuxserver/openssh-server

按照提示操作，生成的密钥将显示在控制台输出，需自行保存。

部署示例

Docker Compose（推荐）

---
services:
  openssh-server:
    image: docker.xuanyuan.run/linuxserver/openssh-server:latest
    container_name: openssh-server
    hostname: openssh-server  # 可选
    environment:
      - PUID=1000               # 用户ID
      - PGID=1000               # 组ID
      - TZ=Etc/UTC              # 时区
      - PUBLIC_KEY=yourpublickey  # 可选，公钥内容
      - PUBLIC_KEY_FILE=/path/to/file  # 可选，公钥文件路径
      - PUBLIC_KEY_DIR=/path/to/directory/containing/_only_/pubkeys  # 可选，公钥目录
      - PUBLIC_KEY_URL=https://github.com/username.keys  # 可选，公钥URL
      - SUDO_ACCESS=false       # 可选，是否允许sudo
      - PASSWORD_ACCESS=false   # 可选，是否允许密码访问
      - USER_PASSWORD=password  # 可选，用户密码
      - USER_PASSWORD_FILE=/path/to/file  # 可选，密码文件路径
      - USER_NAME=linuxserver.io  # 可选，用户名（默认：linuxserver.io）
      - LOG_STDOUT=             # 可选，设置为true将日志输出至stdout
    volumes:
      - /path/to/openssh-server/config:/config  # 配置目录
    ports:
      - 2222:2222               # SSH端口映射
    restart: unless-stopped

Docker CLI

docker run -d \
  --name=openssh-server \
  --hostname=openssh-server `# 可选` \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e PUBLIC_KEY=yourpublickey `# 可选` \
  -e PUBLIC_KEY_FILE=/path/to/file `# 可选` \
  -e PUBLIC_KEY_DIR=/path/to/directory/containing/_only_/pubkeys `# 可选` \
  -e PUBLIC_KEY_URL=https://github.com/username.keys `# 可选` \
  -e SUDO_ACCESS=false `# 可选` \
  -e PASSWORD_ACCESS=false `# 可选` \
  -e USER_PASSWORD=password `# 可选` \
  -e USER_PASSWORD_FILE=/path/to/file `# 可选` \
  -e USER_NAME=linuxserver.io `# 可选` \
  -e LOG_STDOUT= `# 可选` \
  -p 2222:2222 \
  -v /path/to/openssh-server/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/openssh-server:latest

参数说明

参数	功能
`--hostname=`	可选，定义容器主机名
`-p 2222:2222`	SSH端口映射（主机:容器）
`-e PUID=1000`	用户ID，用于权限映射
`-e PGID=1000`	组ID，用于权限映射
`-e TZ=Etc/UTC`	时区，参考时区列表
`-e PUBLIC_KEY=yourpublickey`	可选，公钥内容，自动添加至authorized_keys
`-e PUBLIC_KEY_FILE=/path/to/file`	可选，公钥文件路径（支持Docker secrets）
`-e PUBLIC_KEY_DIR=/path/to/directory`	可选，公钥目录路径（仅包含公钥文件，支持Docker secrets）
`-e PUBLIC_KEY_URL=https://github.com/username.keys`	可选，公钥URL，从URL获取公钥
`-e SUDO_ACCESS=false`	设置为`true`允许sudo访问，未设置密码时为密码less sudo
`-e PASSWORD_ACCESS=false`	设置为`true`允许密码访问，需配合`USER_PASSWORD`或`USER_PASSWORD_FILE`
`-e USER_PASSWORD=password`	可选，用户密码（用于sudo或密码访问）
`-e USER_PASSWORD_FILE=/path/to/file`	可选，密码文件路径（覆盖`USER_PASSWORD`，支持Docker secrets）
`-e USER_NAME=linuxserver.io`	可选，SSH用户名（默认：linuxserver.io）
`-e LOG_STDOUT=`	设置为`true`将日志输出至stdout而非文件
`-v /config`	配置目录，包含所有相关配置文件

从文件加载环境变量（Docker Secrets）

通过 FILE__ 前缀从文件加载环境变量，例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

上述命令将从 /run/secrets/mysecretvariable 文件内容设置 MYVAR 环境变量。

应用运行的Umask设置

通过 -e UMASK=022 覆盖容器内服务的默认umask设置。Umask通过减法调整权限，而非直接设置权限，详情参考 Umask说明。

用户/组ID

使用卷映射时，可通过 PUID 和 PGID 解决权限问题。确保主机卷目录的所有者与容器内的 PUID/PGID 一致。通过以下命令获取当前用户的ID：

id your_user

示例输出：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

通过 Docker Mods 扩展容器功能，上述链接可查看适用于该镜像的特定mods和通用mods。

支持信息

容器内Shell访问

docker exec -it openssh-server /bin/bash

实时监控日志

docker logs -f openssh-server

容器版本号

docker inspect -f '{{ index .Config.Labels "build_version" }}' openssh-server

镜像版本号

docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/openssh-server:latest

更新说明

通过Docker Compose更新

更新镜像：

所有镜像：
```
docker-compose pull
```
单个镜像：
```
docker-compose pull openssh-server
```

更新容器：

所有容器：
```
docker-compose up -d
```
单个容器：
```
docker-compose up -d openssh-server
```

清理旧镜像：
```
docker image prune
```

通过Docker Run更新