SkyWalking 快速上手指南（Docker Compose）

原创于 2025-09-01 00:31:38 发布 · 1.1k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#skywalking #docker #容器 #学习

性能监控专栏收录该内容

82 篇文章

订阅专栏

基于官方推荐的 Docker Compose 方式，帮助你在 5 分钟内搭建一个完整的 SkyWalking 观测平台。

🚀 SkyWalking 快速上手指南（Docker Compose）

✅ 目标：在本地快速启动 SkyWalking OAP、UI 和 Elasticsearch，用于学习与测试。

一、环境准备

请确保你的机器已安装以下工具：

工具	版本要求	安装方式
Docker	≥ 20.10	官网下载
Docker Compose	≥ v2.0	通常随 Docker Desktop 一起安装

💡 提示：Windows 用户建议使用 WSL2 + Docker Desktop；Mac/Linux 用户直接安装即可。

二、步骤 1：克隆官方 Docker 仓库

SkyWalking 官方提供了专门的 docker-sw 仓库，包含多种部署方式。

# 克隆 SkyWalking Docker 仓库（推荐使用 9.7.0 LTS 版本）
git clone https://github.com/apache/skywalking-docker.git

# 进入 9.7.0 + Elasticsearch 7 的 compose 目录
cd skywalking-docker/compose/9.7.0/elasticsearch

📌 当前最新稳定版本是 9.7.0（LTS），搭配 Elasticsearch 7 是最常用的组合。

三、步骤 2：启动服务

# 使用 docker-compose 启动所有服务（后台运行）
docker-compose up -d

首次运行会自动拉取以下镜像：

apache/skywalking-oap-server:9.7.0
apache/skywalking-ui:9.7.0
elasticsearch:7.17.3（或类似版本）

四、步骤 3：验证服务是否启动成功

# 查看容器运行状态
docker-compose ps

你应该看到类似输出：

Name                   Command                  State           Ports
-------------------------------------------------------------------------------
elasticsearch       /bin/tini -- /usr/local/bi ... Up      0.0.0.0:9200->9200/tcp
oap-service         skywalking-oap-server        Up      0.0.0.0:11800->11800/tcp, 12800/tcp
skywalking-ui       /docker-entrypoint.sh          Up      0.0.0.0:8080->8080/tcp

✅ 所有状态为 Up 表示启动成功。

五、步骤 4：访问 SkyWalking UI

打开浏览器，访问：

👉 http://localhost:8080

你将看到 SkyWalking 的 Web 控制台界面，包括：

概览仪表盘（Dashboard）
拓扑图（Topology）
调用链（Trace）
指标监控（Metrics）
告警（Alarm）

🎉 恭喜！SkyWalking 平台已成功运行！

六、常见问题排查

问题	原因	解决方案
页面打不开	容器未启动	运行 `docker-compose logs` 查看日志
Elasticsearch 启动失败	内存不足或 vm.max_map_count 不足	执行： `sudo sysctl -w vm.max_map_count=262144`
OAP 报错连接不到 ES	ES 启动慢，OAP 先启动	等待 1-2 分钟自动重连，或重启 `oap-service`
UI 显示“无数据”	尚未接入应用	接入一个测试应用即可

七、下一步：接入一个 Java 应用（可选）

想看到真实数据？可以运行一个简单的 Spring Boot 应用，并接入 SkyWalking Agent。

示例步骤：

# 下载 SkyWalking Agent（可从镜像中提取，或官网下载）
wget https://downloads.apache.org/skywalking/9.7.0/apache-skywalking-apm-9.7.0.tar.gz
tar -xzf apache-skywalking-apm-9.7.0.tar.gz

启动应用时添加 Agent：

java -javaagent:/path/to/skywalking-agent/skywalking-agent.jar \
     -DSW_AGENT_NAME=my-service \
     -DSW_AGENT_COLLECTOR_BACKEND_SERVICES=localhost:11800 \
     -jar your-spring-boot-app.jar

✅ 发起请求后，回到 UI 页面，即可在“服务”列表中看到 my-service，并查看调用链和指标。

八、停止服务

# 停止并删除容器
docker-compose down

# 如果想清除数据（重置环境）
docker-compose down -v

⚠️ -v 会删除 Elasticsearch 数据卷，慎用。

📌 总结：快速上手四步法

步骤	命令
1. 克隆仓库	`git clone https://github.com/apache/skywalking-docker.git`
2. 进入目录	`cd skywalking-docker/compose/9.7.0/elasticsearch`
3. 启动服务	`docker-compose up -d`
4. 访问 UI	http://localhost:8080