파일 및 운영 도구

WebDAV

사이드바 「파일 서비스」 그룹의 「WebDAV 서비스」에서 설정합니다.

필드	기본값	설명
enable	꺼짐	서비스를 켭니다. 켜려면 사용자가 최소 한 명 필요합니다
listenIp	비어 있음	수신 주소이며 비우면 모든 주소에서 수신합니다
port	18800	수신 포트
tls	꺼짐	HTTPS를 켭니다. 인증서는 SSL 인증서 모듈이 SNI에 따라 제공합니다
users	없음	다중 사용자. 사용자마다 name, password, root(절대 경로 디렉터리), readOnly를 지정하거나 mounts로 여러 디렉터리를 마운트합니다

사용자마다 디렉터리 하나를 매핑하거나 여러 디렉터리를 마운트할 수 있습니다.

• 디렉터리 하나: root와 readOnly를 입력하면 로그인 후의 루트 디렉터리가 해당 디렉터리가 됩니다.
• 디렉터리 여러 개: UI에서 「여러 디렉터리 마운트」를 누르거나 mounts에 여러 항목을 입력합니다. 각 항목은 name(표시 이름, /를 포함할 수 없고 한 사용자 안에서 중복 불가), path(절대 경로), readOnly로 구성됩니다. 로그인하면 루트에 각 디렉터리가 이름별로 나열되며 루트 자체에는 쓸 수 없고 파일을 서로 다른 디렉터리 사이로 이동할 수도 없습니다.

Lucky에서 마이그레이션할 때 사용자의 마운트 목록은 여러 디렉터리로 변환되고, Lucky에서 이름과 비밀번호가 같은 채 중복된 사용자는 하나의 사용자로 병합됩니다.

FTP

「파일 서비스」 그룹의 「FTP 서비스」에서 설정하며 FTP와 FTPS를 지원합니다.

필드	기본값	설명
enable	꺼짐	서비스를 켭니다. 켜려면 사용자가 최소 한 명 필요합니다
listenIp	비어 있음	수신 주소이며 비우면 모든 주소에서 수신합니다
port	2121	수신 포트
passiveStart / passiveEnd	0	패시브 모드 데이터 포트 범위. 둘 다 0이면 시스템이 무작위로 할당하고, 입력할 때는 1 ≤ 시작 ≤ 끝 ≤ 65535를 만족해야 하며 방화벽과 포트 매핑에서 이 범위를 열어 두어야 합니다
publicHost	비어 있음	패시브 모드에서 외부에 알리는 IP. NAT 뒤에 있을 때 공인 IP 또는 포워딩된 IP를 입력하며 IP 주소만 가능하고, 비우면 연결 주소를 자동으로 사용합니다
tlsMode	0	0은 평문과 FTPS 모두 허용, 1은 명시적 FTPS(AUTH TLS) 필수, 2는 암시적 FTPS(연결 즉시 암호화)입니다. 0이 아니면 인증서는 SSL 인증서 모듈이 SNI에 따라 제공합니다
idleTimeout	900	연결이 유휴 상태로 몇 초가 지나면 끊을지
connectionTimeout	30	데이터 연결을 맺는 타임아웃(초)
disableActiveMode	꺼짐	패시브 모드만 사용하며 NAT 환경에 더 적합합니다
users	없음	다중 사용자이며 필드는 WebDAV와 같습니다: name, password, root, readOnly 또는 mounts. 사용자 이름은 중복될 수 없습니다

Lucky의 FTP 설정에서 서비스 매개변수와 사용자를 가져올 수 있습니다(Lucky에서 마이그레이션 참고).

스토리지 마운트

「파일 서비스」 그룹의 「스토리지 마운트」에서 마운트 지점을 추가하고 페이지 안에서 파일을 온라인으로 관리합니다.

필드	설명
name, remark, enable	이름, 메모, 사용 스위치
type	local(로컬 디렉터리), webdav(원격 WebDAV) 또는 smb(SMB 공유)
path	로컬 디렉터리이며 이미 존재하는 절대 경로여야 합니다(local에서 사용)
url, username, password	원격 주소와 계정. 비밀번호는 UI에서 마스킹됩니다(webdav, smb에서 사용). WebDAV 주소는 http:// 또는 https://로 시작하고, SMB 주소는 smb://호스트[:포트]/공유이름[/하위디렉터리] 형식이며 SMB2/3를 지원합니다. 사용자 이름을 비우면 게스트로 접속합니다
skipVerify	HTTPS 인증서 검증을 건너뜁니다(webdav에서 사용)
domain	SMB 인증에 사용할 도메인 또는 작업 그룹. 보통 비워 둡니다(smb에서 사용)
readOnly	읽기 전용 마운트이며 파일 관리가 모든 쓰기 작업을 거부합니다

Lucky의 스토리지 관리에서 로컬 디렉터리와 WebDAV 스토리지를 가져올 수 있으며 Aliyun Drive와 시스템 마운트는 가져오지 않습니다.

온라인 파일 관리는 디렉터리 탐색, 파일 다운로드, 스트리밍 업로드(파일 전체를 메모리에 올리지 않음), 디렉터리 생성, 이름 변경, 삭제를 지원합니다. 마운트 지점은 백업 작업의 대상 위치로 쓸 수 있으며 백업 파일은 마운트 지점의 지정한 디렉터리에 기록되고 보관 정책에 따라 오래된 파일이 정리됩니다.

Wake-on-LAN

「Wake-on-LAN」에서 장치를 관리하며 장치로 매직 패킷(6바이트 0xFF 뒤에 MAC을 16번 반복)을 보냅니다.

필드	기본값	설명
name	없음	장치 이름, 필수
macs	없음	MAC 주소를 한 줄에 하나씩, 최소 하나이며 같은 장치에 여러 개 입력할 수 있습니다
broadcastIps	비어 있음	IPv4 브로드캐스트 주소. 비우면 255.255.255.255와 활성화된 각 네트워크 인터페이스의 브로드캐스트 주소로 전송합니다
port	9	대상 UDP 포트
repeat	3	MAC마다 반복 전송하는 횟수, 상한 20
checkAddr	비어 있음	온라인 점검 주소. 형식은 호스트:포트이며 예: 192.168.1.10:3389, 비우면 점검하지 않습니다
remark	비어 있음	메모

장치 목록에서 깨우기를 누르면 매직 패킷을 보내고 checkAddr에 따라 장치의 온라인 여부를 표시합니다.

예약 작업

cron 표현식에 따라 정해진 시간에 명령을 실행하거나 HTTP 요청을 보냅니다.

• spec은 표준 5필드 표현식, 선택 사항인 초 필드(6필드, 예: */30 * * * * *), @every 10m, @daily 같은 디스크립터를 지원합니다.
• type이 command이면 sh -c(Windows는 임시 .bat)로 command를 실행하며 환경 변수에 taskName과 GATELY_ 접두사가 붙은 같은 이름의 대문자 변수를 주입합니다.
• type이 http이면 http 설정에 따라 요청을 보내며 필드는 url, method(GET, POST, PUT, PATCH, DELETE), headers(항목마다 Key: Value), body, successContent(응답 본문에 이 중 하나라도 포함되어야 성공이며 비우면 2xx만 확인), timeout, insecureSkipVerify입니다.
• 작업을 켜거나 끌 수 있고 페이지에 다음 실행 시간이 표시되며 수동으로 즉시 실행할 수도 있습니다.
• 같은 작업의 이전 실행이 아직 끝나지 않았으면 이번 실행은 건너뜁니다.
• 작업마다 최근 20회의 실행 기록을 보관하며 시작 시간, 소요 시간, 성공 여부, 수동 실행 여부, 출력(최대 4000자 요약)이 포함됩니다.
• 생성 폼은 표현식 파싱 검증을 제공합니다.

개요와 시스템 로그

• 「개요」 페이지에는 호스트 정보(CPU 모델, 사용률과 부하, 메모리, 디스크, 네트워크 인터페이스 주소와 실시간 속도, 공인 IPv4와 IPv6(누르면 복사)), 각 모듈의 서비스 상태, Gately 프로세스의 버전, 커밋, 빌드 시간, 시작 시간, PID, CPU, 상주 메모리, Go 힙과 고루틴 수가 표시됩니다.
• 「시스템 로그」 페이지에는 Docker, FTP, 예약 작업 등을 포함한 각 모듈의 실행 기록이 모여 표시됩니다.

테마

UI는 15개 팔레트를 Gately 오리지널(에메랄드, 오션, 프레시, 벚꽃, 노을, 미드나이트, 펑크)과 클래식(GitHub, Nord, Dracula, Catppuccin, Tokyo Night, Gruvbox, Rosé Pine, Solarized) 두 그룹으로 제공하며, 모든 팔레트에 라이트와 다크 버전이 있습니다. 모드는 라이트, 다크, 시스템 따라가기 중에서 고를 수 있고, 시스템 따라가기는 현재 팔레트의 라이트 또는 다크 버전을 사용합니다. 어느 팔레트든 강조색을 10가지 프리셋 중 하나나 시스템 색상 선택기로 바꿀 수 있으며, 로고와 로그인 페이지 그라데이션도 함께 바뀝니다. 팔레트를 다시 선택하면 사용자 강조색은 해제됩니다. 모서리는 직각, 팔레트 기본값, 둥글게 중에서 고를 수 있습니다. 테마 설정은 브라우저에 로컬로 저장됩니다.