Swift (arm64v8) Docker 镜像文档

镜像概述

本镜像是 Swift 官方镜像 的 arm64v8 架构专用版本，提供高性能系统编程语言 Swift 的运行与开发环境。Swift 具有简洁现代的语法，支持与 C/Objective-C 代码及框架无缝交互，默认保证内存安全，同时兼顾系统级编程的性能需求。该镜像适用于在 arm64v8 架构环境中开发、测试和部署 Swift 应用程序。

如需了解更多关于 Swift 语言的信息，请访问 swift.org。

核心功能与特性

语言特性

• 高性能：优化的编译型语言，适合系统级编程
• 现代语法：简洁易读，减少样板代码
• 内存安全：默认启用内存安全机制，降低内存错误风险
• 多语言交互：无缝访问现有 C/Objective-C 代码及框架
• 完整生态：支持模块系统、泛型、协议、闭包等高级特性

镜像特性

• 多版本支持：涵盖 Swift 5.10 至 6.2 等稳定版本
• 多基础系统：基于 Ubuntu、Debian、Amazon Linux 2、RHEL UBI 等多种 Linux 发行版
• 架构优化：专为 arm64v8 架构构建，适配嵌入式设备及 ARM 服务器
• 变体选择：提供完整版本（含开发工具）与精简版本（仅运行时依赖）

支持的标签

以下为当前支持的主要标签及对应基础系统（完整标签列表可参考 官方仓库）：

Swift 6.2.x 系列

Swift 6.1.x / 6.0.x / 5.10.x 系列

均提供与 6.2.x 系列类似的标签格式，涵盖对应版本及基础系统组合（具体版本号可参考 官方标签列表）。

使用场景

• 交互式学***：通过 REPL 快速测试 Swift 语法及特性
• 开发环境：在容器中构建和调试 Swift 应用，避免本地环境依赖冲突
• 持续集成：作为 CI/CD 流程的构建环境，确保编译一致性
• 生产部署：使用 slim 标签部署轻量级 Swift 服务

使用方法

前提条件

• 已安装 Docker 且支持 arm64v8 架构（如 Apple Silicon Mac、arm64 Linux 设备）
• 具备基本 Docker 命令操作能力

1. 拉取镜像

从 Docker Hub 拉取指定版本镜像（默认拉取 latest 标签）：

# 拉取最新版本
docker pull arm64v8/swift

# 拉取指定版本（如 6.2-slim）
docker pull arm64v8/swift:6.2-slim

2. 启动 Swift REPL

通过以下命令启动交互式 Swift REPL（需添加 SYS_PTRACE 权限以支持调试）：

docker run --cap-add SYS_PTRACE -it --rm arm64v8/swift swift

• --cap-add SYS_PTRACE：添加进程跟踪权限，确保 REPL 正常运行
• -it：启用交互式终端
• --rm：退出后自动删除容器

3. 创建并运行容器

临时容器（用于测试）

创建临时容器并进入 bash 终端：

docker run --cap-add SYS_PTRACE -it --rm arm64v8/swift /bin/bash

持久化容器（用于开发）

创建命名容器，便于后续复用：

# 创建并启动容器（命名为 swift-dev）
docker run --cap-add SYS_PTRACE -it --name swift-dev arm64v8/swift /bin/bash

# 退出容器后，如需重新进入
docker start swift-dev  # 启动容器
docker attach swift-dev  # 附加终端

4. 部署 Swift 应用示例

以简单 Swift 脚本为例，通过挂载本地目录运行：

1. 本地创建 main.swift 文件：

print("Hello, Swift Docker!")

2. 挂载当前目录并执行脚本：

docker run --cap-add SYS_PTRACE -it --rm -v $(pwd):/app arm64v8/swift swift /app/main.swift

• -v $(pwd):/app：将本地当前目录挂载到容器内 /app 路径

5. Docker Compose 配置示例

创建 docker-compose.yml 文件，定义 Swift 服务：

version: '3.8'
services:
  swift-app:
    image: arm64v8/swift:6.2-slim
    cap_add:
      - SYS_PTRACE
    volumes:
      - ./src:/app  # 挂载应用代码目录
    working_dir: /app
    command: swift run  # 运行应用（需确保 src 目录包含 Package.swift）
    tty: true
    stdin_open: true

启动服务：

docker-compose up

镜像变体说明

标准版本（无 -slim 标签）

• 包含内容：完整 Swift 工具链（编译器、调试器、包管理器）、系统依赖库
• 适用场景：开发、编译、调试 Swift 应用
• 示例标签：6.2, jammy, amazonlinux2

精简版本（含 -slim 标签）

• 包含内容：仅保留运行时依赖，移除编译器及开发工具
• 适用场景：生产环境部署（减小镜像体积，降低攻击面）
• 示例标签：6.2-slim, noble-slim, rhel-ubi9-slim

支持与反馈

维护者

由 Swift 社区 维护。

获取帮助

• Swift Docker 社区论坛
• GitHub 仓库 Issues（组件标注 Docker）

镜像更新

• 镜像更新跟踪：official-images 仓库 library/swift 标签
• 源码变更历史：swift-docker 仓库

许可证信息

• Swift 语言许可证：参见 swift.org/LICENSE.txt
• 镜像依赖组件：包含 Ubuntu/Debian 等基础系统及第三方库，其许可证信息可通过 repo-info 仓库 查询

使用须知：使用本镜像即表示您同意遵守所有包含软件的许可证条款。

!Swift Logo