logologo
시작
가이드
개발
플러그인
API
홈
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
시작
가이드
개발
플러그인
API
홈
logologo
NocoBase 작동 방식
설치 방법 및 버전 비교

NocoBase 설치

Docker 설치
create-nocobase-app 설치
Git 소스 코드 설치
환경 변수

NocoBase 업그레이드

Docker 설치 업그레이드
create-nocobase-app 설치 업그레이드
Git 소스 코드 설치 업그레이드

배포

프로덕션 환경 배포

정적 리소스 프록시

nginx
caddy
cdn

일반적인 운영 명령어

docker compose
pm2
더 빠른 배포 방법
플러그인 설치 & 업그레이드
Previous Page설치 방법 및 버전 비교
Next Pagecreate-nocobase-app 설치
AI 번역 알림

이 문서는 AI에 의해 번역되었습니다. 정확한 정보는 영어 버전을 참조하세요.

#Docker 설치

필수 조건
  • Docker와 Docker Compose가 설치되어 있어야 합니다.
  • Docker 서비스가 실행 중인지 확인하세요.

#1. docker-compose.yml 파일 생성

# NocoBase가 생성할 시스템 파일을 저장할 'my-project' (다른 이름도 가능합니다) 폴더를 생성합니다.
mkdir my-project && cd my-project

# 빈 `docker-compose.yml` 파일을 생성합니다.
vi docker-compose.yml

#2. docker-compose.yml 설정

NocoBase 버전(버전 비교)과 데이터베이스 유형을 선택한 다음, 해당 설정을 docker-compose.yml 파일에 복사하세요.

설정 안내
  • 이미지 선택: latest latest-full beta beta-full alpha alpha-full 1.7.14 1.7.14-full
    • 프로덕션 환경에서는 의도치 않은 자동 업그레이드를 방지하기 위해 특정 버전 번호를 고정하는 것을 권장합니다. 모든 버전 보기
    • Docker Hub 이미지: nocobase/nocobase:latest-full
    • full 이미지에는 백업 관리 및 마이그레이션 관리 플러그인에 필요한 PostgreSQL 16/17 클라이언트, MySQL 8.0 클라이언트, Oracle 19.25 클라이언트와 템플릿 인쇄(PDF)에 필요한 LibreOffice가 포함되어 있습니다.
    • 자체 이미지를 빌드해야 하는 경우, 공식 Dockerfile (경량 버전)과 Dockerfile-full (전체 버전)을 참조할 수 있습니다.
  • APP_KEY 수정: your-secret-key를 임의의 문자열로 변경하세요. 이 키는 사용자 토큰과 같은 민감한 정보를 암호화하는 데 사용됩니다.
  • 기존 데이터베이스 사용: 이미 데이터베이스 서비스가 있는 경우, DB_HOST를 데이터베이스 서버 주소로 변경하고 데이터베이스 서비스 설정(예: postgres, mysql, mariadb 서비스)을 삭제하거나 주석 처리하세요.
  • 포트 매핑: 기본적으로 컨테이너의 80번 포트는 호스트의 13000번 포트에 매핑됩니다. 필요에 따라 수정할 수 있습니다.
Latest 버전
Beta 버전
Alpha 버전
PostgreSQL
MySQL
MariaDB
networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:latest-full
    restart: always
    networks:
      - nocobase
    depends_on:
      - postgres
    environment:
      # 애플리케이션 키. 사용자 토큰 등을 생성하는 데 사용됩니다.
      # APP_KEY가 변경되면 이전 토큰도 무효화됩니다.
      # 임의의 무작위 문자열이 될 수 있으며, 외부에 유출되지 않도록 주의하세요.
      - APP_KEY=your-secret-key
      # 데이터베이스 유형. postgres, mysql, mariadb를 지원합니다.
      - DB_DIALECT=postgres
      # 데이터베이스 호스트. 기존 데이터베이스 서버 IP로 대체할 수 있습니다.
      - DB_HOST=postgres
      # 데이터베이스 포트
      - DB_PORT=5432
      # 데이터베이스 이름
      - DB_DATABASE=nocobase
      # 데이터베이스 사용자
      - DB_USER=nocobase
      # 데이터베이스 비밀번호
      - DB_PASSWORD=nocobase
      # 시간대. 필요에 따라 현지 시간대로 변경하세요. (예: Asia/Seoul)
      - TZ=Asia/Shanghai

    volumes:
      - ./storage:/app/nocobase/storage
    ports:
      - '13000:80'
    # init: true

  # 기존 데이터베이스 서비스를 사용하는 경우, postgres를 시작하지 않아도 됩니다.
  postgres:
    image: postgres:16
    restart: always
    command: postgres -c wal_level=logical
    environment:
      POSTGRES_USER: nocobase
      POSTGRES_DB: nocobase
      POSTGRES_PASSWORD: nocobase
    volumes:
      - ./storage/db/postgres:/var/lib/postgresql/data
    networks:
      - nocobase

#3. NocoBase 설치 및 시작

# 최신 이미지를 가져옵니다.
docker compose pull

# 백그라운드에서 실행합니다. (첫 실행 시 자동으로 설치가 진행됩니다)
docker compose up -d

# 설치 및 실행 로그를 확인합니다.
docker compose logs -f app

app-postgres-app-1  | nginx started
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ cross-env DOTENV_CONFIG_PATH=.env node -r dotenv/config packages/app/server/lib/index.js install -s
app-postgres-app-1  | Done in 2.72s.
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ pm2-runtime start --node-args="-r dotenv/config" packages/app/server/lib/index.js -- start
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: Launching in no daemon mode
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] starting in -fork mode-
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] online
app-postgres-app-1  | 🚀 NocoBase server running at: http://localhost:13000/

#4. NocoBase 로그인

브라우저에서 http://localhost:13000을 엽니다. 초기 계정은 admin@nocobase.com이고 비밀번호는 admin123입니다.

계정 보안 알림

처음 로그인한 후에는 시스템 보안을 위해 기본 비밀번호를 즉시 변경해 주세요.