Hermes: 두 판 사이의 차이

2026년 6월 20일 (토) 13:14 판

개요

설치

과정	설명	비고
준비		sudo apt update sudo apt install -y curl
설치	필요한 것들이 자동 설치되는데, 꽤 걸린다.	curl -fsSL https://openclaw.ai/install.sh \| bash
확인	버전 출력되면 성공. 이후 자동으로 설정 진행.	openclaw --version

지원 환경

지원되는 운영체제와 요구사항은 다음과 같습니다.

요구사항
항목	요구 조건
운영체제	Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
PHP	8.2 이상
데이터베이스	MariaDB 10.6+, MySQL 8+, PostgreSQL 13+, SQLite 3
웹서버	Apache 2.4+, Nginx + PHP-FPM
메모리	2GB 이상 (권장 4GB)
저장 공간	1GB 이상

준비물

설치 전에 다음을 준비합니다.

웹서버 접근 권한 또는 로컬 서버 환경
데이터베이스 생성 권한 (운영 환경)
Hermes 설치 파일 또는 Git 소스

설치 절차

1. 설치 파일 얻기

Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.

Git

git clone https://github.com/example/hermes.git
cd hermes

또는 배포 파일

[source|https://example.com/hermes/releases]

2. 의존성 설치

PHP 의존 패키지를 설치합니다.

composer install

3. 데이터베이스 생성

운영 환경에서는 먼저 DB를 생성합니다.

MariaDB 예시

CREATE DATABASE hermes DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'hermes_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON hermes.* TO 'hermes_user'@'localhost';

4. 웹 서버 설정

Apache 또는 Nginx에서 설치 경로를 웹root로 연결합니다.

Apache: `DocumentRoot` 설정
Nginx: `root` 설정과 `index.php` 처리

5. 초기화 실행

설치 스크립트 또는 웹 초기화 페이지를 실행합니다.

웹: `http://your-domain/install.php`
CLI: `php bin/hermes install`

기본 설정

설치 후 `LocalSettings.php`(미디어위키) 또는 Hermes 전용 설정 파일에서 값을 조정합니다.

권장 설정 항목
항목	권장값	설명
언어	ko	위키 언어
업로드 허용	true	파일 업로드 활성화
로그 레벨	warning	로그 출력 수준
캐시	enabled	캐시 활성화

기본 설정 예시:

$wgLanguageCode = 'ko';
$wgEnableUploads = true;
$wgLogLevel = 'warning';

확인 방법

설치가 성공했는지 확인합니다.

Hermes 메인 페이지 접속
`Hermes/변경이력` 페이지 존재 확인
관리자 패널에서 상태 확인

자주 나는 오류

업로드 불가

웹서버 `upload_max_filesize` 설정 확인
PHP `memory_limit` 확인

데이터베이스 연결 오류

DB 사용자 권한 재확인
`host`, `port`, `charset` 설정 확인

웹서버 404 오류

DocumentRoot 또는 `root` 경로 확인
`index.php` 처리 규칙 확인

@@ 21번째 줄: / 21번째 줄: @@
 |openclaw --version
 |}
+== 지원 환경 ==
+지원되는 운영체제와 요구사항은 다음과 같습니다.
+{| class="wikitable"
+|+ 요구사항
+|-
+! 항목
+! 요구 조건
+|-
+| 운영체제
+| Linux (Ubuntu 20.04+), macOS 12+, Windows 10+
+|-
+| PHP
+| 8.2 이상
+|-
+| 데이터베이스
+| MariaDB 10.6+, MySQL 8+, PostgreSQL 13+, SQLite 3
+|-
+| 웹서버
+| Apache 2.4+, Nginx + PHP-FPM
+|-
+| 메모리
+| 2GB 이상 (권장 4GB)
+|-
+| 저장 공간
+| 1GB 이상
+|}
+== 준비물 ==
+설치 전에 다음을 준비합니다.
+* 웹서버 접근 권한 또는 로컬 서버 환경
+* 데이터베이스 생성 권한 (운영 환경)
+* Hermes 설치 파일 또는 Git 소스
+== 설치 절차 ==
+=== 1. 설치 파일 얻기 ===
+Git으로 소스를 가져오거나 공식 배포 파일을 다운로드합니다.
+# Git
+<source lang="bash">
+git clone https://github.com/example/hermes.git
+cd hermes
+</source>
+# 또는 배포 파일
+[source|https://example.com/hermes/releases]
+=== 2. 의존성 설치 ===
+PHP 의존 패키지를 설치합니다.
+<source lang="bash">
+composer install
+</source>
+=== 3. 데이터베이스 생성 ===
+운영 환경에서는 먼저 DB를 생성합니다.
+# MariaDB 예시
+<source lang="sql">
+CREATE DATABASE hermes DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+CREATE USER 'hermes_user'@'localhost' IDENTIFIED BY 'your_password';
+GRANT ALL PRIVILEGES ON hermes.* TO 'hermes_user'@'localhost';
+</source>
+=== 4. 웹 서버 설정 ===
+Apache 또는 Nginx에서 설치 경로를 웹root로 연결합니다.
+* Apache: `DocumentRoot` 설정
+* Nginx: `root` 설정과 `index.php` 처리
+=== 5. 초기화 실행 ===
+설치 스크립트 또는 웹 초기화 페이지를 실행합니다.
+* 웹: `http://your-domain/install.php`
+* CLI: `php bin/hermes install`
+== 기본 설정 ==
+설치 후 `LocalSettings.php`(미디어위키) 또는 Hermes 전용 설정 파일에서 값을 조정합니다.
+{| class="wikitable"
+|+ 권장 설정 항목
+|-
+! 항목
+! 권장값
+! 설명
+|-
+| 언어
+| ko
+| 위키 언어
+|-
+| 업로드 허용
+| true
+| 파일 업로드 활성화
+|-
+| 로그 레벨
+| warning
+| 로그 출력 수준
+|-
+| 캐시
+| enabled
+| 캐시 활성화
+|}
+기본 설정 예시:
+<source lang="php">
+$wgLanguageCode = 'ko';
+$wgEnableUploads = true;
+$wgLogLevel = 'warning';
+</source>
+== 확인 방법 ==
+설치가 성공했는지 확인합니다.
+* Hermes 메인 페이지 접속
+* `Hermes/변경이력` 페이지 존재 확인
+* 관리자 패널에서 상태 확인
+== 자주 나는 오류 ==
+=== 업로드 불가 ===
+* 웹서버 `upload_max_filesize` 설정 확인
+* PHP `memory_limit` 확인
+=== 데이터베이스 연결 오류 ===
+* DB 사용자 권한 재확인
+* `host`, `port`, `charset` 설정 확인
+=== 웹서버 404 오류 ===
+* DocumentRoot 또는 `root` 경로 확인
+* `index.php` 처리 규칙 확인
 [[분류:Hermes]]