# [spug]docker安裝配置spug
###### tags `spug`
:::info
:bulb: [官方文檔](https://www.spug.cc/docs/install-docker/)
:::

## :triangular_flag_on_post: 什麼是Spug
:::warning
　Spug是面向中小型企業設計的輕量級無Agent的自動化運維平台，整合了主機管理、主機批量執行、主機在線終端、文件在線上傳下載、應用發布部署、在線任務計劃、配置中心、監控、報警等一系列功能。
:::

## :triangular_flag_on_post: Spug功能特色
:::warning
- 批量執行: 主機命令在線批量執行
- 在線終端: 主機支持瀏覽器在線終端登錄
- 文件管理: 主機文件在線上傳下載
- 任務計劃: 靈活的在線任務計劃
- 發布部署: 支持自定義發布部署流程
- 配置中心: 支持KV、文本、json 等格式的配置
- 監控中心: 支持站點、端口、進程、自定義等監控
- 報警中心: 支持短信、郵件、釘釘、微信等報警方式
- 優雅美觀: 基於Ant Design 的UI界面
- 開源免費: 前後端代碼完全開源
:::

## :triangular_flag_on_post: 安裝並運行

拉取鏡像
阿里雲的鏡像與Docker hub同步更新，國內用戶建議使用阿里雲的鏡像。
:::warning
docker pull registry.aliyuncs.com/openspug/spug
:::

啟動容器
:::warning
如果需要持久化存儲代碼和數據，可以添加：-v 映射容器內/data路徑。
官方鏡像內置了 Mysql 數據庫，如果需要使用外部已有數據庫（Mysql 5.6+），可以參考 此文檔 設置後再進行下一步的初始化操作。
:::

## :triangular_flag_on_post: 根據需要，以下兩種啟動方式任選其一即可。

持久化存儲啟動命令：
/spug 指的是映射本地的磁片路徑，也可以是其他目錄，/data是容器內代碼和數據初始化存儲的路徑
:::warning
docker run -d --restart=always --name=spug -p 5566:80 -v /spug:/data registry.aliyuncs.com/openspug/spug
:::

如果你需要在spug內使用docker命令則需要添加額外的參數
:::warning
docker run -d --restart=always --name=spug -p 5566:80 -v /spug/:/data -v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker registry.aliyuncs.com/openspug/spug
:::


## :triangular_flag_on_post: 初始化
以下操作會創建一個用戶名為 admin 密碼為 spug.dev 的管理員賬戶，可自行替換管理員賬戶。
:::warning
docker exec spug init_spug admin spug.dev
:::


## :triangular_flag_on_post: 訪問
:::warning
在瀏覽器中輸入 http://localhost:5566 訪問。

用户名： admin
密码： spug.dev

:::


## :triangular_flag_on_post: 版本升級
你可以在 官網 系统管理/系统设置/关于 中查看當前運行的 Spug 版本，可以在 更新日誌 查看當前最新版本，如果需要升級 Spug 請參考以下升級文檔。

:::warning
spug 是容器名稱，也可以替換為自己的容器ID
docker exec -i spug python3 /data/spug/spug_api/manage.py update
:::
:::warning
更新完成後重啟容器
docker restart spug
:::