dockge - GitLite

KO | EN

gitlite — search

#hacktoberfest #llm #golang #android #deep-learning #windows #awesome #cli #vue #security #openai #ios #mcp #open-source

dockge

(★ 24,115)

화려하고 사용하기 쉬우며 반응형인 자체 호스팅 방식의 docker compose.yaml 스택 기반 관리자

파일 탐색기

최종 버전 다운로드 (.zip)

- - exclude.txt
- - ask-for-help.yml
  - feature-request.yml
- - ask-for-help.yaml
  - bug_report.yaml
  - feature_request.yaml
  - security.md
- - ci.yml
  - close-incorrect-issue.yml
  - json-yaml-validate.yml
  - nightly-release.yml
  - prevent-file-change.yml
- FUNDING.yml
- PULL_REQUEST_TEMPLATE.md
- - docker-socket-handler.ts
  - terminal-socket-handler.ts
- - 2023-10-20-0829-setting-table.ts
  - 2023-10-20-0829-user-table.ts
  - 2023-12-20-2117-agent-table.ts
- - agent.ts
  - user.ts
- - main-router.ts
- - agent-proxy-socket-handler.ts
  - main-socket-handler.ts
  - manage-agent-socket-handler.ts
- - limit-queue.ts
- agent-manager.ts
- agent-socket-handler.ts
- check-version.ts
- database.ts
- dockge-server.ts
- index.ts
- log.ts
- password-hash.ts
- rate-limiter.ts
- router.ts
- settings.ts
- socket-handler.ts
- stack.ts
- terminal.ts
- util-server.ts
- agent-socket.ts
- util-common.ts
- Base.Dockerfile
- BuildHealthCheck.Dockerfile
- Dockerfile
- close-incorrect-issue.js
- env2arg.js
- healthcheck.go
- mark-as-nightly.ts
- reformat-changelog.ts
- reset-password.ts
- test-docker.ts
- update-version.ts
- - apple-touch-icon.png
  - favicon.ico
  - icon-192x192.png
  - icon-512x512.png
  - icon.svg
  - manifest.json
- - App.vue
  - i18n.ts
  - icon.ts
  - main.ts
  - router.ts
  - util-frontend.ts
  - vite-env.d.ts
- components.d.ts
- index.html
- vite.config.ts
.dockerignore
.editorconfig
.eslintrc.cjs
.gitignore
compose.yaml
CONTRIBUTING.md
LICENSE
package-lock.json
package.json
README.md
SECURITY.md
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](./frontend/public/icon.svg)

# Dockge
멋지고 사용하기 쉬우며 반응형인 자체 호스팅 docker compose.yaml 스택 기반 관리자입니다.
[![GitHub Repo stars](https://img.shields.io/github/stars/louislam/dockge?logo=github&style=flat)](https://github.com/louislam/dockge) [![Docker Pulls](https://img.shields.io/docker/pulls/louislam/dockge?logo=docker)](https://hub.docker.com/r/louislam/dockge/tags) [![Docker Image Version (latest semver)](https://img.shields.io/docker/v/louislam/dockge/latest?label=docker%20image%20ver.)](https://hub.docker.com/r/louislam/dockge/tags) [![GitHub last commit (branch)](https://img.shields.io/github/last-commit/louislam/dockge/master?logo=github)](https://github.com/louislam/dockge/commits/master/)
![](https://github.com/louislam/dockge/assets/1336778/26a583e1-ecb1-4a8d-aedf-76157d714ad7)
비디오 보기: https://youtu.be/AWAlOQeNpgU?t=48
## ⭐ 주요 기능
- 🧑‍💼 `compose.yaml` 파일 관리
- 생성/편집/시작/중지/재시작/삭제
- Docker 이미지 업데이트
- ⌨️ `compose.yaml`용 인터랙티브 편집기
- 🦦 인터랙티브 웹 터미널
- 🕷️ (1.4.0 🆕) 다중 에이전트 지원 - 단일 인터페이스에서 여러 Docker 호스트의 여러 스택을 관리할 수 있습니다.
- 🏪 `docker run ...` 명령어를 `compose.yaml`로 변환
- 📙 파일 기반 구조 - Dockge는 구성 파일을 가로채지 않으며, 평소처럼 드라이브에 저장됩니다. 일반 `docker compose` 명령어로 상호작용할 수 있습니다.
![](https://github.com/louislam/dockge/assets/1336778/cc071864-592e-4909-b73a-343a57494002)
- 🚄 반응형 - 모든 것이 매우 빠르게 반응합니다. 진행 상황(Pull/Up/Down)과 터미널 출력이 실시간으로 표시됩니다.
- 🐣 사용하기 쉽고 멋진 UI - Uptime Kuma의 UI/UX를 좋아하신다면 이 프로그램도 마음에 드실 것입니다.
![](https://github.com/louislam/dockge/assets/1336778/89fc1023-b069-42c0-a01c-918c495f1a6a)
## 🔧 설치 방법
요구 사항:
- [Docker](https://docs.docker.com/engine/install/) 20+ / Podman
- (Podman 전용) podman-docker (Debian: `apt install podman-docker`)
- 운영체제:
- Docker/Podman을 실행할 수 있는 주요 Linux 배포판:
- ✅ Ubuntu
- ✅ Debian (Bullseye 이상)
- ✅ Raspbian (Bullseye 이상)
- ✅ CentOS
- ✅ Fedora
- ✅ ArchLinux
- ❌ Debian/Raspbian Buster 이하는 지원되지 않습니다.
- ❌ Windows (추후 지원 예정)
- 아키텍처: armv7, arm64, amd64 (일명 x86\_64)
### 기본
- 기본 스택 디렉토리: `/opt/stacks`
- 기본 포트: 5001
```
# 스택을 저장할 디렉토리와 Dockge의 스택을 저장할 디렉토리를 생성합니다.
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge
# compose.yaml 다운로드
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml
# 서버 시작
docker compose up -d
# docker-compose V1 또는 Podman을 사용하는 경우
# docker-compose up -d
```
이제 Dockge가 http://localhost:5001 에서 실행됩니다.
### 고급
스택을 다른 디렉토리에 저장하려는 경우, 사용자 지정 쿼리 문자열이 포함된 다음 URL을 사용하여 compose.yaml 파일을 생성할 수 있습니다.
```
# compose.yaml 다운로드
curl "https://dockge.kuma.pet/compose.yaml?port=5001&stacksPath=/opt/stacks" --output compose.yaml
```
- port=`5001`
- stacksPath=`/opt/stacks`
또한 compose가 생성/다운로드되면, 스택 소유권을 설정하기 위해 compose의 `environment:` 섹션에 아래의 `PUID` 및 `PGID` 섹션을 추가하세요. 그렇지 않으면 기본값은 `root`가 됩니다.
```
# 작동하려면 PUID와 PGID가 모두 설정되어야 합니다.
- PUID=1000 # 스택 파일/디렉토리의 소유권을 이 사용자로 설정합니다.
- PGID=1000 # 스택 파일/디렉토리의 소유권을 이 그룹으로 설정합니다.
```
인터랙티브 compose.yaml 생성기 이용 가능 주소:
https://dockge.kuma.pet
### -또는-
다음에서 compose 내용을 복사하여 붙여넣으세요:
스택을 다른 디렉토리에 저장하려면 `DOCKGE\_STACKS\_DIR` 환경 변수와 볼륨을 변경할 수 있습니다.
compose:
```
services:
dockge:
image: louislam/dockge:1
restart: unless-stopped
ports:
# Host Port:Container Port
- 5001:5001
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/app/data
# 비공개 레지스트리를 사용하려면 인증 파일을 Dockge와 공유해야 합니다:
# - /root/.docker/:/root/.docker
# S
```

tacks 디렉토리
# 호스트의 stacks 디렉토리 (컨테이너 내의 경로는 호스트와 정확히 일치해야 합니다)
# ⚠️ 잘못 설정할 경우, 데이터가 엉뚱한 경로에 기록될 수 있습니다.
# ✔️ 올바른 예시: - /my-stacks:/my-stacks (두 경로가 일치함)
# ❌ 잘못된 예시: - /docker:/my-stacks (두 경로가 일치하지 않음)
- /opt/stacks:/opt/stacks
environment:
# Dockge에 stacks 디렉토리의 위치를 알려줍니다
- DOCKGE\_STACKS\_DIR=/opt/stacks
# 기능이 정상 작동하려면 PUID와 PGID 모두 설정해야 합니다
- PUID=1000 # stack 파일/디렉토리의 소유권을 이 유저로 설정합니다
- PGID=1000 # stack 파일/디렉토리의 소유권을 이 그룹으로 설정합니다
```
## 업데이트 방법
```bash
cd /opt/dockge
docker compose pull && docker compose up -d
```
## 스크린샷
![](https://github.com/louislam/dockge/assets/1336778/e7ff0222-af2e-405c-b533-4eab04791b40)
![](https://github.com/louislam/dockge/assets/1336778/7139e88c-77ed-4d45-96e3-00b66d36d871)
![](https://github.com/louislam/dockge/assets/1336778/f019944c-0e87-405b-a1b8-625b35de1eeb)
![](https://github.com/louislam/dockge/assets/1336778/a4478d23-b1c4-4991-8768-1a7cad3472e3)
## 개발 동기
- 그동안 Portainer를 사용해 왔지만, stack 관리 측면에서는 때때로 만족스럽지 않았습니다. 예를 들어, stack 배포를 시도할 때 로딩 아이콘이 진행 없이 몇 분 동안 계속 돌기만 하는 경우가 있습니다. 그리고 오류 메시지가 명확하지 않을 때도 있습니다.
- ES Module + TypeScript로 개발하고자 합니다
이 프로젝트가 마음에 드신다면 ⭐를 눌러주세요.
## 🗣️ 커뮤니티 및 기여
### 버그 리포트
https://github.com/louislam/dockge/issues
### 도움 요청 / 토론
https://github.com/louislam/dockge/discussions
### 번역
Dockge를 모국어로 번역하고 싶으시다면 [Translation Guide](https://github.com/louislam/dockge/blob/master/frontend/src/lang/README.md)를 읽어주세요.
### 풀 리퀘스트 생성
모든 유형의 풀 리퀘스트를 수용하는 것은 아니며 시간을 낭비해 드리고 싶지 않으므로 반드시 [가이드](https://github.com/louislam/dockge/blob/master/CONTRIBUTING.md)를 읽어주세요.
## 자주 묻는 질문 (FAQ)
#### "Dockge"란 무엇인가요?
"Dockge"는 제가 직접 만든 조어입니다. 원래는 `Dodge`처럼 발음되기를 원했으나, 많은 사람들이 `Dockage`라고 부르기도 하며 이 역시 허용됩니다.
이름의 아이디어는 `sadge`, `bedge`, `wokege` 같은 Twitch 감정 표현에서 얻었습니다. 이들은 모두 `-ge`로 끝납니다.
#### `compose.yaml` 없이 단일 컨테이너를 관리할 수 있나요?
Dockge의 주된 목표는 모든 것에 Docker `compose.yaml`을 사용하도록 하는 것입니다. 단일 컨테이너를 관리하고 싶다면 Portainer나 Docker CLI를 사용하시면 됩니다.
#### 기존 stack을 관리할 수 있나요?
네, 가능합니다. 다만 compose 파일을 stacks 디렉토리로 이동해야 합니다:
1. stack을 중지합니다
2. compose 파일을 `/opt/stacks//compose.yaml`로 이동합니다
3. Dockge 우측 상단의 드롭다운 메뉴에서 "Scan Stacks Folder" 버튼을 클릭합니다
4. 이제 목록에서 stack을 확인할 수 있습니다
#### Dockge는 Portainer의 대체품인가요?
그렇기도 하고 아니기도 합니다. Portainer는 많은 Docker 기능을 제공합니다. 반면 Dockge는 현재 더 나은 사용자 인터페이스와 사용자 경험을 갖춘 docker-compose에만 집중하고 있습니다.
docker-compose로만 컨테이너를 관리하고 싶다면 대답은 '예'일 수 있습니다.
docker network나 단일 컨테이너 같은 무언가를 여전히 관리해야 한다면 대답은 '아니오'일 수 있습니다.
#### Dockge와 Portainer를 둘 다 설치할 수 있나요?
네, 가능합니다.
## 기타 사항
Dockge는 [Compose V2](https://docs.docker.com/compose/migrate/)를 기반으로 제작되었습니다. `compose.yaml`은 `docker-compose.yml`로도 알려져 있습니다.