本文使用「署名 4.0 国际 (CC BY 4.0)」许可协议，欢迎转载、或重新修改使用，但需要注明来源。 [署名 4.0 国际 (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/deed.zh)

本文作者: 苏洋

创建时间: 2022年07月17日
统计字数: 2751字
阅读时间: 6分钟阅读
本文链接: https://soulteary.com/2022/07/17/build-your-own-go-playground-with-docker.html

-----


# 使用 Docker 搭建属于你自己的 Go Playground

本篇文章将介绍如何通过容器来部署属于你自己的 Go Playground。

Go Playground 是 Golang 团队推出的在线语言工具，不论是对于初学者而言，还是对 Golang 开发者来说，它都不失为一个简单好用的神器。

但由于种种原因，国内部分用户使用这个功能可能会遇到一些网络问题，而无法使用这个服务；以及出于运行代码包含一些“隐私”，而无奈放弃这个服务。

## 写在前面

这个周末花了一些时间，对 Golang [官方 Go Playground 项目](https://github.com/golang/playground)进行了一些调整，让项目能够轻松的在 GCE 环境之外的普通 Docker 容器环境中运行起来，让我们能够在本地快速验证各种 Golang 代码片段。

调整后的项目有哪些特点呢：

- 支持完全离线运行，无需“联网”，不需担心有任何信息泄漏的风险（比如包含密钥的程序）。
- 支持使用容器进行快速启动，不锁定任何公有云或者复杂的运行环境。
- 和官方程序一样，使用沙盒方式运行 Golang 程序，确保运行程序安全，无副作用。
- 和官方程序一样，使用 `faketime` “模块”，让程序能够提供确定性的输出，让程序复现和结果缓存变的更加容易。
- 合并了来自 `go.dev` 的默认示例，并进行了适当的界面“汉化”。
- 大幅精简程序模块和依赖，减少不必要的资源消耗。

完整的项目代码，我已经上传到了 GitHub，如果你需要的话，[可以自取](https://github.com/soulteary/golang-playground)。

## 准备工作

想要使用这个项目非常简单，准备工作只有三步：准备 Docker 环境、下载容器镜像、准备容器编排文件。

### 准备 Docker 环境

我们需要先完成 Docker 运行环境的安装，如果你的本地环境中已经安装了 Docker，那么可以跳过这个小节，阅读后面的内容。

如果你是桌面运行环境，可以访问官网[下载安装文件](https://www.docker.com/get-started/)，如果你使用的是服务端环境，可以参考这篇文章中的“[更简单的 Docker 安装](https://soulteary.com/2022/06/21/building-a-cost-effective-linux-learning-environment-on-a-laptop-the-basics.html#%E6%9B%B4%E7%AE%80%E5%8D%95%E7%9A%84-docker-%E5%AE%89%E8%A3%85)”，来完成 Docker 环境的准备。

### 获取必要的容器镜像

在 Docker 环境就绪之后，我们需要执行下面的命令，来获取必要的容器镜像：

```
docker pull soulteary/golang-playground:web-1.18.4
docker pull soulteary/golang-playground:sandbox-1.18.4
docker pull soulteary/golang-playground:actuator-1.18.4
docker pull memcached:1.6.15-alpine
```

### 准备容器编排文件

在镜像文件就绪之后，我们需要先编写一个容器编排文件，来定义各种容器服务该如何运行：

```yaml
version: '3'
services:

  sandbox:
    image: soulteary/golang-playground:sandbox-1.18.4
    restart: always
    command: -mode=server -listen=0.0.0.0:80 -workers=1 -untrusted-container=soulteary/golang-playground:actuator-1.18.4
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - playground
    depends_on:
      - memcached

  web:
    image: soulteary/golang-playground:web-1.18.4
    restart: always
    environment:
      - SANDBOX_BACKEND_URL=http://sandbox:/run
      - MEMCACHED_ADDR=memcached:11211
    ports:
      - 8080:8080
    depends_on:
      - sandbox
    networks:
      - playground

  memcached:
    image: memcached:1.6.15-alpine
    command: memcached -m 64
    networks:
      - playground
networks: 
  playground:
```

将上面的文件保存为 `docker-compose.yml` 之后，我们使用 `docker-compose up -d` 或 `docker compose up -d`（新版本 Docker） 命令来启动程序。

## 使用程序

在启动程序之后，我们打开浏览器，访问 `http://localhost:8080`，就可以开始快捷的 Golang 之旅啦。

![浏览器中的界面](https://attachment.soulteary.com/2022/07/17/go-playground.jpg)

你可以在“代码文本框”中自行输入代码，然后点击“运行”，来让代码在容器中完成自动编译、构建、链接、运行等一系列操作。

也可以使用顶部菜单栏的“内置示例”下拉框，来选择某一个例子，学习如何使用 Golang 或者这个工具，比如：启动并验证 HTTP 服务器的返回、在一个编辑器中同时使用多个 Go 程序文件、如何编写单元测试、如何使用并发来进行科学计算等等...

## 其他

如果你想了解 Go Playground 这个项目背后的“黑魔法”，可以阅读[这篇官方博客](https://blog.go-zh.org/playground)，里面详细的介绍了项目的由来、如何模拟时钟、避免死锁、模拟文件系统、模拟网络调用等。

**这些实现，是官方应用和目前开源社区里的其他三方实现的主要差别。**换言之，如果不进行这些“tricks”，Playground 的计算结果的稳定性和结果的一致性其实存在比较大的挑战。

当然，为了避免 DDoS 攻击，官方还在实现中添加了 MemCached 组件，来缓存计算过程和结果。（支持 Sleep 这类异步输出的日志结果）

## 最后

关于 Go Playground 如何使用 Docker 进行本地化部署就聊到这里。

我们下一篇文章再见。

--EOF