当前位置： 首页 > news >正文

CasaOS：基于Docker的个人云操作系统安装与实战指南

news 2026/6/30 5:39:52

最近在折腾家庭服务器和私有云方案时，发现很多朋友都在寻找一个既轻量又功能全面的个人云操作系统。从Docker管理、文件共享到应用商店，如果有一个统一的Web界面来管理这一切，那将极大提升效率。今天要和大家深入探讨的，正是这样一个备受关注的开源项目——由IceWhaleTech团队开发的CasaOS。

CasaOS定位为“你的个人云操作系统”，它基于Docker技术，旨在为家庭服务器、NAS设备或任何运行Linux的硬件提供一个简洁、美观且功能强大的Web管理面板。无论你是想搭建一个家庭媒体中心、一个私有网盘，还是想学习Docker容器化部署，CasaOS都能提供一个极佳的起点。本文将带你从零开始，全面了解CasaOS，包括其核心概念、安装部署、基础配置、应用安装、硬盘共享以及国内环境下的优化实践，并分享一些常见问题的排查思路和最佳实践。

1. 背景与核心概念：什么是CasaOS？

在深入动手之前，我们有必要先搞清楚CasaOS到底是什么，以及它能为我们解决什么问题。

1.1 CasaOS的定义与定位

CasaOS不是一个独立的操作系统内核，而是一个运行在现有Linux发行版（如Debian、Ubuntu、Raspberry Pi OS等）之上的云操作系统界面和管理平台。你可以把它理解为一个高度集成化的Docker容器管理面板，但它又不止于此。它通过一个现代化的Web UI，将服务器上的存储、应用、设备和服务统一管理起来，目标是让个人和家庭用户也能像使用商业云服务一样轻松地管理自己的数字资产。

其核心基于Docker和Docker Compose，这意味着CasaOS上运行的几乎所有“应用”都是以容器形式存在的。这种设计带来了极好的隔离性和可移植性，一个应用及其配置可以很容易地备份或迁移到另一台服务器上。

1.2 解决了哪些痛点？

对于个人开发者、极客或家庭用户而言，手动管理服务器通常面临以下挑战：

  • Docker命令复杂：对于不常使用命令行的用户，通过docker run或编写docker-compose.yml来部署应用有一定门槛。
  • 管理分散：文件服务（如Samba）、下载工具（如qBittorrent）、媒体服务器（如Jellyfin）等通常各自为政，配置和访问入口不统一。
  • 缺乏应用发现：寻找适合在家庭服务器上运行的有趣应用需要花费时间搜索和测试。
  • 状态监控不便：快速查看服务器CPU、内存、存储使用情况以及各个容器的运行状态需要组合使用多个命令。

CasaOS正是为了解决这些问题而生。它提供了一个“应用商店”，可以一键安装预配置好的常用应用；一个文件管理器，方便地浏览和共享服务器文件；一个仪表盘，实时监控系统资源；以及一个统一的设置中心。

1.3 核心组件与架构

了解CasaOS的架构有助于后续的问题排查：

  1. 前端 (Frontend)：基于Vue.js开发的现代化Web界面，用户与之交互的部分。
  2. 后端 (Backend)：主要由Go语言编写，提供RESTful API，负责与Docker引擎、系统进行通信。
  3. Docker引擎 (Docker Engine)：CasaOS的基石，所有应用都运行在Docker容器中。
  4. CasaOS应用商店：一个包含社区贡献的Docker Compose模板仓库。当你点击“安装”时，CasaOS后端会从该仓库拉取对应的docker-compose.yml文件并部署。
  5. 系统服务：CasaOS会安装一些必要的服务，例如用于文件索引的casaos-gateway、用于消息传递的casaos-message-bus等。

简单来说，用户通过Web UI操作，后端API接收指令并转化为Docker命令执行，最终将结果反馈给前端展示。

2. 环境准备与安装部署

“工欲善其事，必先利其器”。在安装CasaOS之前，我们需要准备好合适的环境。

2.1 硬件与系统要求

  • 硬件：理论上任何能运行Linux的设备都可以，包括x86/64的旧电脑、英特尔NUC、树莓派（ARM架构）等。建议内存至少1GB，存储空间不少于10GB。
  • 操作系统：一个干净的Linux发行版。官方主要支持：
    • Ubuntu 20.04/22.04 LTS
    • Debian 11/12
    • Raspberry Pi OS (基于Debian)
  • 核心依赖：Docker和Docker Compose。这是CasaOS运行的前提条件。

2.2 安装Docker与Docker Compose

如果你的系统还没有安装Docker，请先进行安装。以下以Ubuntu/Debian为例：

# 1. 更新软件包索引并安装必要工具 sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release # 2. 添加Docker官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 3. 设置Docker稳定版仓库 echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 4. 更新源并安装Docker引擎 sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin # 5. 验证Docker安装 sudo docker run hello-world

安装成功后，运行hello-world容器应该会看到欢迎信息。docker-compose-plugin是Docker Compose V2的集成版本，可以通过docker compose命令使用。

2.3 一键安装CasaOS

CasaOS提供了极其简便的一键安装脚本。这是最推荐的安装方式。

# 使用官方脚本安装 curl -fsSL https://get.casaos.io | sudo bash

这个脚本会自动检测你的系统架构，下载并安装最新版本的CasaOS及其相关服务。安装过程可能需要几分钟，请耐心等待。

安装成功标志：当脚本执行完毕，你通常会看到类似下面的输出，其中包含了访问CasaOS的Web地址（通常是http://你的服务器IP:80）。

CasaOS 安装成功！ 请访问: http://192.168.1.100

2.4 访问与初始化设置

  1. 打开浏览器，输入上一步得到的IP地址（例如http://192.168.1.100）。
  2. 首次访问会进入初始化设置向导。
  3. 选择语言：支持中文，选择“简体中文”。
  4. 设置用户名和密码：这是你登录CasaOS Web管理界面的凭证，请务必牢记。
  5. 配置存储：向导会提示你选择一块硬盘或分区作为CasaOS的默认存储位置。通常选择你数据盘挂载的路径（如/mnt/sda1）。如果你只有系统盘，也可以先选择系统盘下的一个目录（如/DATA）。重要：建议使用独立的、容量较大的数据盘，避免系统盘被填满。
  6. 完成设置后，即可进入CasaOS的主仪表盘。

3. 核心功能详解与实战操作

成功登录后，我们来看看CasaOS的核心功能如何使用。

3.1 仪表盘与系统监控

主界面即仪表盘，展示了：

  • 系统状态：CPU使用率、内存使用量、存储空间占用、网络流量概览。
  • 快捷方式：可以添加快捷方式，直接打开已安装应用的管理界面。
  • 最近文件：显示最近访问或修改的文件。
  • 运行中的应用：以卡片形式展示正在运行的Docker应用，可以快速停止、重启或打开。

这是你管理服务器的“总控台”，所有关键信息一目了然。

3.2 应用商店与一键部署

这是CasaOS最吸引人的功能之一。点击左侧菜单的“应用商店”。

  • 浏览应用：商店分类清晰，包含媒体、工具、开发、网络等各类常用应用的Docker模板，如Jellyfin、Nextcloud、Home Assistant、Bitwarden等。
  • 安装应用：找到想安装的应用，点击“安装”。CasaOS会弹出一个配置对话框。
  • 配置应用：在安装对话框中，通常需要配置：
    • 应用名称：在CasaOS中显示的名字。
    • 网络端口：容器内部端口映射到宿主机的哪个端口。例如，Jellyfin内部端口是8096，你可以映射到宿主机的8096端口（如果冲突可以改成8097）。
    • 存储卷 (Volumes)：这是关键！你需要将容器内的数据目录（如配置文件、媒体库）映射到宿主机的物理路径上，这样数据才会持久化，不会随容器删除而丢失。例如，将/config映射到/mnt/sda1/appdata/jellyfin/config。
    • 环境变量：一些应用需要特定的环境变量来配置。
  • 部署：配置完成后点击“部署”，CasaOS后端会自动拉取镜像、创建容器并启动。你可以在“我的应用”中看到它的状态。

示例：安装Jellyfin媒体服务器

  1. 在应用商店找到“Jellyfin”。
  2. 点击安装，在配置页面：
    • 应用名：My-Jellyfin
    • 端口：8096:8096(主机端口:容器端口)
    • 卷映射：添加两条
      • /mnt/sda1/media:/media(媒体文件目录)
      • /mnt/sda1/appdata/jellyfin/config:/config(配置目录)
  3. 点击“部署”。等待镜像拉取和容器启动。
  4. 启动后，点击应用卡片上的“打开”，即可访问Jellyfin的Web界面进行后续媒体库设置。

3.3 文件管理

CasaOS内置了一个简洁的文件管理器。点击左侧菜单的“文件”，你可以：

  • 浏览服务器上的目录和文件。
  • 进行上传、下载、删除、重命名、移动等基本操作。
  • 创建文本文件或文件夹。
  • 查看图片和播放视频（部分格式）。

对于简单的文件操作非常方便，但它并非要替代专业的FTP或Samba服务，更多是作为内置的便捷工具。

3.4 系统设置

点击左下角的“设置”图标，可以进入系统设置页面，这里包含：

  • 常规：修改CasaOS的显示名称、时区、语言等。
  • 用户：管理登录CasaOS的用户账户（目前版本多用户功能较简单）。
  • 存储：管理服务器上的磁盘和分区，可以在这里格式化、挂载新硬盘。
  • 网络：查看网络接口信息。
  • CasaOS：检查更新、查看日志、重启或停止CasaOS服务。

4. 进阶实战：共享硬盘与网络存储 (Samba)

很多用户使用CasaOS的初衷之一是搭建一个家庭网络存储中心，能够在Windows、macOS、手机等设备上像访问本地文件夹一样访问服务器上的文件。这需要通过Samba协议来实现。

4.1 为什么需要单独配置Samba？

虽然CasaOS文件管理器可以在浏览器内管理文件，但无法直接提供SMB/CIFS网络共享协议。因此，我们需要在CasaOS之外，在宿主机系统上安装和配置Samba服务。或者，更符合Docker哲学的方式是：通过CasaOS应用商店安装一个Samba容器。

4.2 通过Docker容器部署Samba服务

这是更推荐的方式，因为容器化部署更干净，不影响宿主机系统，且易于管理。

  1. 规划目录：首先确定你要共享的宿主机目录。例如，我们想共享整个数据盘/mnt/sda1下的public文件夹。

    sudo mkdir -p /mnt/sda1/public sudo chmod -R 777 /mnt/sda1/public # 仅为示例，生产环境应设置更严格的权限

  2. 安装Samba容器：

    • 进入CasaOS的“应用商店”。
    • 搜索“Samba”。你可能会找到如dperson/samba或servercontainers/samba这类镜像的模板。
    • 如果没有现成模板，我们可以使用“自定义安装”功能。

  3. 自定义安装Samba：

    • 在应用商店，点击右上角的“自定义安装”。
    • 在“镜像”栏填入：dperson/samba(这是一个非常流行的Samba Docker镜像)。
    • 应用名称：My-Samba-Share
    • 端口：Samba通常使用137-139和445端口，但这些是特权端口。更安全的做法是不映射这些端口，而是使用network_mode: host让容器共享宿主机的网络栈。但CasaOS的UI可能不支持直接配置网络模式为host。因此，我们可以选择另一种方式：在“高级设置”或通过修改生成的Compose文件来配置。
    • 更实用的方法：使用Shell安装由于CasaOS UI对复杂Docker配置的支持有限，对于Samba这种需要特殊网络权限的服务，直接使用docker run命令或编写docker-compose.yml文件更直接。

  4. 通过SSH使用Docker命令部署： 连接到你的服务器终端，执行以下命令：

    # 创建一个专用的docker-compose文件 cd /mnt/sda1/appdata mkdir samba cd samba nano docker-compose.yml

    将以下内容粘贴到docker-compose.yml文件中：

    version: '3.8' services: samba: image: dperson/samba container_name: samba restart: unless-stopped network_mode: "host" # 使用主机网络模式，简化配置 environment: - USERID=1000 # 设置文件所有者的UID，通常是你登录用户的UID，可用`id -u`命令查看 - GROUPID=1000 # GID，可用`id -g`查看 - TZ=Asia/Shanghai volumes: - /mnt/sda1/public:/share/public # 将宿主机目录挂载到容器的/share/public # 你可以添加更多卷，例如 - /mnt/sda1/family:/share/family command: > # 通过命令参数配置共享 -s "public;/share/public;yes;no;yes;all;none" -u "yourusername;yourpassword" # 添加一个Samba用户和密码 -p -g "guest account = nobody" -g "map to guest = bad user" # 注意：-s 参数格式： “共享名;路径;可浏览;只读;可写;允许用户;拒绝用户”

    修改其中的USERID/GROUPID、挂载卷路径以及-u参数中的用户名和密码。 保存并退出编辑器（在nano中按Ctrl+X，然后按Y，再按Enter）。 启动服务：

    docker-compose up -d

  5. 在CasaOS中添加快捷方式（可选）： 虽然Samba服务不是在CasaOS应用商店里安装的，但你仍然可以把它添加到“我的应用”中方便管理。

    • 在CasaOS“我的应用”页面，点击“添加应用”。
    • 选择“自定义”，填写应用名称（如Samba），图标可以留空或找一个Samba的图标URL。
    • 最重要的，在“链接”处填写你服务器的IP地址（例如smb://192.168.1.100）。这样点击这个卡片就会尝试在本地打开网络共享。
    • 你也可以将Samba管理界面（如果有的话）或一个说明文档的链接放在这里。

  6. 客户端访问：

    • Windows：打开文件资源管理器，在地址栏输入\\你的服务器IP，例如\\192.168.1.100，回车。输入上面配置的用户名(yourusername)和密码(yourpassword)即可看到public共享文件夹。
    • macOS：访达 -> 前往 -> 连接服务器，输入smb://你的服务器IP，例如smb://192.168.1.100。
    • Android/iOS：可以使用支持SMB的文件管理器App，如“Solid Explorer”、“FE文件管理器”等，添加SMB服务器地址、用户名和密码。

5. 国内环境优化与常见问题排查

在国内网络环境下使用CasaOS，可能会遇到拉取Docker镜像慢、应用商店加载缓慢等问题。下面提供一些优化思路和常见问题的解决方法。

5.1 配置Docker镜像加速器

这是提升Docker镜像下载速度最有效的方法。修改Docker守护进程的配置。

# 编辑或创建daemon.json配置文件 sudo nano /etc/docker/daemon.json

将以下内容写入（如果文件已存在，请将registry-mirrors项合并到现有JSON中）：

{ "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com", "https://mirror.baidubce.com" ] }

保存退出后，重启Docker服务使配置生效：

sudo systemctl restart docker

你可以运行docker info查看Registry Mirrors是否已经包含你设置的地址。

5.2 CasaOS应用商店与社区源

CasaOS的应用商店模板默认从GitHub仓库拉取。如果访问缓慢，可以考虑使用国内社区维护的镜像源。请注意：切换源可能存在版本滞后或兼容性问题，请谨慎操作，并优先考虑使用网络加速工具解决GitHub访问问题。

目前有一些社区项目提供了CasaOS应用商店的国内镜像，其原理通常是替换CasaOS中定义的AppStore仓库地址。具体操作方法可能随CasaOS版本变化，一般需要修改CasaOS的配置文件。由于此操作涉及系统文件修改，且非官方支持，在此不提供具体命令。建议在遇到商店无法加载时，优先检查服务器本身的网络连通性。

5.3 常见问题与排查思路

问题现象可能原因排查与解决思路
安装脚本执行失败网络问题无法连接到GitHub或下载服务器；系统缺少依赖（如curl）。1. 检查网络：ping github.com
2. 尝试使用代理或更换网络环境后重试。
3. 确保已安装curl:sudo apt install -y curl。
安装后无法访问Web界面防火墙未开放80端口；CasaOS服务未成功启动；IP地址错误。1. 检查服务状态：sudo systemctl status casaos
2. 检查端口监听：sudo netstat -tlnp | grep :80
3. 检查防火墙：sudo ufw status，如需开放端口：sudo ufw allow 80/tcp
4. 确认访问IP：在服务器上执行hostname -I查看IP。
应用商店空白或加载慢网络无法访问GitHub；DNS解析问题。1. 在服务器上尝试curl https://raw.githubusercontent.com测试连通性。
2. 修改DNS服务器为114.114.114.114或223.5.5.5。
Docker应用安装失败Docker镜像拉取失败；端口冲突；存储路径权限不足；docker-compose.yml模板错误。1. 查看容器日志：在CasaOS应用卡片点击“日志”，或使用docker logs <容器名>
2. 检查端口占用：sudo ss -tulnp | grep :端口号
3. 检查目录权限：确保映射的宿主机目录存在且CasaOS/Docker有读写权限（可尝试chmod 755或chown给当前用户）。
4. 配置Docker镜像加速器（见上文）。
文件管理器无法写入挂载的磁盘目录权限问题。1. 检查目录所有者：ls -ld /mnt/sda1
2. 通常CasaOS以root或特定用户运行容器，确保该用户对目录有权限。一个临时测试方法是：sudo chmod -R 777 /mnt/sda1(生产环境不推荐，应设置精确的用户组权限)。
系统更新后出现问题新版本与旧配置或已安装应用不兼容。1. 在更新前，务必备份重要的应用数据（即你映射到宿主机的那些卷目录）。
2. 关注官方GitHub的Release Notes，了解破坏性变更。
3. 如果更新后无法启动，可以尝试查看CasaOS服务日志：journalctl -u casaos -f。

6. 最佳实践与工程建议

为了让你的CasaOS系统运行得更稳定、更安全，遵循以下最佳实践非常重要。

6.1 存储规划与数据持久化

  • 系统与数据分离：强烈建议将操作系统安装在SSD或小容量硬盘上，而将数据（Docker卷、媒体文件、备份）存储在大容量的HDD或另一块SSD上，并挂载到/mnt或/data下。
  • 清晰的目录结构：为Docker应用数据建立规范的目录，例如：
    /mnt/bigdisk/ ├── appdata/ # 所有Docker容器的配置和数据 │ ├── jellyfin/ │ ├── nextcloud/ │ └── samba/ ├── media/ # 媒体库（电影、音乐、照片） ├── backup/ # 备份文件 └── public/ # 网络共享文件
  • 务必使用卷映射：在CasaOS安装任何应用时，绝对不能省略“卷映射”配置。这是保证你的数据在容器删除或更新后依然存在的唯一方法。始终将容器内的数据目录（如/config,/data,/etc/mysql）映射到宿主机的物理路径。

6.2 安全加固

  • 修改默认密码：安装后立即修改CasaOS的默认登录密码。
  • 使用非root用户运行Docker（可选但推荐）：可以将用户加入docker组来免sudo运行docker命令，但这仍有安全风险。对于生产环境，考虑使用Rootless Docker模式。
  • 谨慎映射特权端口：避免将容器应用映射到宿主机的80、443、22等敏感端口，除非必要。可以使用非特权端口（如8080、8443）然后通过反向代理（如Nginx Proxy Manager）转发。
  • 定期更新：定期更新CasaOS本身、Docker引擎以及运行中的容器镜像，以获取安全补丁。
    # 更新CasaOS sudo casaos-update # 更新所有运行中的容器镜像（谨慎操作，需有回滚方案） docker compose pull && docker compose up -d
  • 防火墙配置：仅开放必要的端口（如80用于CasaOS，其他应用的特定端口）。关闭不必要的服务。

6.3 备份策略

  • 备份应用数据：定期备份你在宿主机上映射的卷目录（即/mnt/bigdisk/appdata/等）。可以使用rsync或tar命令打包压缩，并传输到另一台机器或云存储。
  • 备份Docker Compose文件：对于通过“自定义安装”或手动docker-compose.yml部署的应用，将这些YAML文件妥善保存。它们是重建服务的蓝图。
  • 考虑使用Portainer进行可视化管理：你可以在CasaOS中安装Portainer。它是一个更专业的企业级Docker管理UI，提供了更强大的容器管理、堆栈（Stack）部署、模板和备份恢复功能，可以作为CasaOS的补充。

6.4 网络与性能

  • 使用Host网络模式需谨慎：network_mode: host虽然能简化网络配置（如Samba），但会牺牲一定的容器网络隔离性。大多数应用使用默认的桥接网络即可。
  • 资源限制：对于资源消耗大的应用（如视频转码），可以在Docker Compose中为其设置CPU和内存限制，防止单个应用拖垮整个服务器。
    services: myapp: image: some/image deploy: resources: limits: cpus: '2.0' memory: 4G
  • 日志管理：Docker容器日志默认会占用磁盘空间。可以配置Docker守护进程的日志驱动和轮转策略，或者定期清理旧日志。

通过本文的梳理，你应该已经对CasaOS有了一个全面的认识——从它解决的核心痛点、安装部署、基本使用，到进阶的硬盘共享配置，再到国内环境优化和必须掌握的避坑指南。CasaOS最大的优势在于它极大地降低了个人用户玩转Docker和家庭服务器的门槛，将复杂的命令行操作封装成直观的点击。

然而，它本质上是一个“上层管理面板”，其稳定性和功能深度依赖于底层的Docker和Linux系统。因此，在学习使用CasaOS的同时，也建议逐步了解一些基础的Docker命令和Linux知识，这样在遇到问题时你才能更有底气地去排查和解决。例如，学会使用docker ps、docker logs、docker exec这些命令，会让你在管理容器时事半功倍。

下一步，你可以尝试用CasaOS部署更多的服务，比如搭建一个私有云盘Nextcloud、一个自动化工具Home Assistant，或者一个密码管理器Bitwarden。在实践中，你会更深刻地体会到容器化带来的便利。如果在部署中遇到问题，多查看容器日志，善用社区和搜索引擎，大部分问题都能找到解决方案。

http://www.jsqmd.com/news/1094062/

相关文章：

  • Claude Code 2026 安装指南 并改调用DeepSeek模型
  • 吉阳区正宗椰子鸡推荐｜符合海南本土特色的宝藏门店
  • Linux：进程
  • ZW3D二次开发_工程图_获取/设置参考是否隐藏消隐线
  • SpringBoot 整合 MinIO 实现文件存储——私有化 OSS 方案
  • Java synchronized 与 ReentrantLock 对比分析
  • 《AI抢产能致车规存储缺货？欣芯半导体给出eMMC/UFS“供应韧性”破局与选型指南》
  • Solo DSP数据集成模块的架构设计
  • MCP协议与Playwright结合：实现零代码浏览器自动化
  • 商用级云PACS源码，云影像源码，B/S 架构 DICOM 标准，HIS 双向对接、Redis 缓存开箱即用
  • Versal GTM（1）：收发器概览
  • 2026去水印不破坏原图的方法！电脑手机在线无痕去水印工具+PS教程
  • 如何甄选靠谱展厅设计公司：从效果到落地的实战指南
  • 实测拆解！Paperxie智能写作，解锁毕业论文标准化高效创作方式
  • 【system-architect】：一个让 AI 做架构建议时“说得清依据“的 Skill
  • Java计算机毕设之基于 Java 的部门通知与任务一体化管理系统 团队协作型任务分配管理系统(完整前后端代码+说明文档+LW，调试定制等）
  • TI BOOSTXL-RS232 BoosterPack硬件解析与RS-232通信实战指南
  • 2026美容院会员管理系统选型攻略：功能对比+避坑指南
  • 查询优化-提升子查询-UNION类型
  • 怎么查看招标信息？新手找标入门指南
  • 2026奶茶店收银系统维护商推荐解析：凤梨收银系统适配茶饮业态的专业参考
  • 专业的杭州Geo哪家有实力
  • UV诱导黑化模型下的化妆品防晒黑功效评价方法
  • 【学习笔记】垂直领域大模型：行业微调实战指南（9/35）
  • AI驱动下的SEO关键词优化新趋势与实践解析
  • Windows风扇控制终极指南：Fan Control让你的电脑静音又高效
  • STM32和STM32CubeMX实现SHT30温湿度传感器 保姆级教程
  • 社区公益服务平台 Java+SpringBoot+Vue 前后分离
  • RAG 答不准？多半不是模型不行，是缺了 Rerank
  • dart_common_extensions：一套 Dart 常用扩展方法集合