FileStation

이름

유형

경로

📦 Docker 볼륨 마운트 가이드

📌 작동 원리
Docker 컨테이너는 호스트 파일에 직접 접근할 수 없습니다. docker-compose.yml에서 호스트 폴더를 컨테이너에 마운트한 후, 위 경로란에 컨테이너 경로를 입력하세요.

예시 1: 호스트 폴더 연결

docker-compose.yml에 volumes: - E:/movies:/mnt/storage/movies 추가 후,
위 경로란에 /mnt/storage/movies 입력 → E:\movies 폴더가 외부 스토리지로 추가됩니다.

# docker-compose.yml
services:
  filestation:
    volumes:
      - E:/movies:/mnt/storage/movies      # 윈도우 호스트 폴더
      - /home/user/docs:/mnt/storage/docs  # 리눅스 호스트 폴더
      - D:/photos:/mnt/storage/photos      # 다른 드라이브

예시 2: NAS (시놀로지 등) SMB 연결

① 호스트에서 NAS 공유 폴더를 먼저 마운트
② docker-compose.yml에 마운트 경로 추가
③ 위 경로란에 컨테이너 경로 입력

# 1단계: 호스트에서 NAS 마운트
sudo mount -t cifs //192.168.1.50/video /mnt/nas_video \
  -o username=admin,password=mypass,vers=3.0

# 2단계: docker-compose.yml
services:
  filestation:
    volumes:
      - /mnt/nas_video:/mnt/storage/nas_video

# 3단계: 위 경로란에 /mnt/storage/nas_video 입력

부팅 시 자동 마운트 (/etc/fstab)

# /etc/fstab — 부팅 시 자동 마운트
//192.168.1.50/video /mnt/nas_video cifs \
  credentials=/etc/smbcredentials,vers=3.0,_netdev 0 0

# /etc/smbcredentials 파일 (chmod 600)
username=admin
password=mypass

⚠️ docker-compose.yml 수정 후 docker compose down && docker compose up -d 실행해야 적용됩니다.

💡 Windows: net use로 자동 연결
🐧 Linux/Docker: mount.cifs 사용. docker-compose.yml에 cap_add: [SYS_ADMIN, DAC_READ_SEARCH] 필요, 컨테이너에 cifs-utils 설치 필요.
📦 권장: 호스트에서 SMB 마운트 후 로컬/네트워크 경로 유형 사용 (위 가이드 참고)

호스트

공유 이름

사용자명 (선택)

비밀번호 (선택)

호스트

포트

사용자명

비밀번호

루트 경로 (선택)

패시브 모드 SSL/TLS 사용

호스트

포트

사용자명

인증 방식

비밀번호

SSH 개인키

루트 경로 (선택)

서버 URL

사용자명

비밀번호

엔드포인트 (S3 호환)

리전

버킷

Access Key ID

Secret Access Key

프리픽스 (선택)

설명

용량 제한

무제한 디스크 용량 표시 (실제 디스크 용량 기준 진행바) 용량 직접 설정

저장 시 현재 사용량 계산

📁 폴더별 권한

사용자별 특정 폴더의 접근을 제어합니다. 설정된 폴더는 스토리지 권한보다 우선 적용됩니다.

📖 사용방법

• 권한 종류
  ✅ 표시 — 폴더 목록에서 보이기/숨기기
  ✅ 읽기 — 다운로드, 미리보기, 검색 허용
  ✅ 쓰기 — 업로드, 이름변경, 삭제, 이동 허용

• 동작 방식
  - 미설정 폴더는 스토리지 권한을 따름 (기본 보임)
  - 설정된 폴더만 아래 규칙대로 적용
  - 관리자에게도 동일하게 적용
  - 폴더만 제어하며, 파일은 항상 보임

• 폴더 추가
  1. 위에서 사용자 선택 → 📂 폴더 추가 클릭
  2. 찾아보기 모달에서 폴더 체크 → 선택 적용

• 기존 폴더에 사용자 추가
  1. 폴더 펼치기 (▶) → ➕ 사용자 추가 클릭
  2. 모달에서 사용자 선택 → 추가

• 권한 수정
  - ✅/❌ 클릭하면 즉시 개별 권한 변경
  - 폴더 체크 → "선택 수정"으로 일괄 변경 가능

• 사용 예시
  "영화/성인" 폴더 → 사용자 "guest"에게 표시 ❌ 설정
  → guest는 해당 폴더를 볼 수 없음. 다른 폴더는 정상 표시.

ID	이름	경로	유형	용량	설명	관리

🔄 자동 승인 ⚙️ 설정 변경

🆕 신규회원 기본 용량:

아이디	이름	역할	용량	상태	가입일	마지막 로그인	관리

아이디 (3~20자, 영문/숫자/_)

비밀번호

표시 이름 (최대 30자)

이메일

역할

상태

저장 용량 제한

👤 내 정보

🔑 아이디 -

👤 표시 이름 -

📧 이메일 -

📅 가입일 -

🌐 접속 IP -

🌍 접속 국가 -

🌐 언어

정보 수정

표시 이름

이메일

비밀번호 변경

현재 비밀번호

새 비밀번호

새 비밀번호 확인

일반 설정

회원가입 허용

활성화하면 로그인 화면에서 회원가입이 가능합니다.

자동 승인

활성화하면 가입 즉시 로그인할 수 있습니다. 비활성화하면 관리자 승인이 필요합니다.

개인 폴더 외부 공유 허용

비활성화하면 사용자가 개인 폴더의 파일을 외부 링크로 공유할 수 없습니다.

아이디/비밀번호 찾기 허용

비활성화하면 로그인 화면에서 아이디/비밀번호 찾기 기능이 숨겨집니다. (SMTP 설정 필요)

세션 유지 시간 (분)

지정된 시간 동안 활동이 없으면 자동 로그아웃됩니다. 기본값: 1시간

사용자당 최대 동시 작업 수

사용자별 동시 복사/이동/삭제 작업 수를 제한합니다. 기본값: 5

스토리지 경로 설정

개인폴더 루트 경로

사용자별 개인폴더가 저장되는 위치입니다. (예: E:\WebHard\users 또는 /mnt/data/users)

공유폴더 루트 경로

공유폴더가 저장되는 위치입니다. (예: E:\WebHard\shared 또는 /mnt/data/shared)

휴지통 경로

삭제된 파일이 저장되는 위치입니다. (예: E:\WebHard\trash 또는 /mnt/data/trash)

⚠️ 주의사항

경로 변경 시 기존 파일은 자동으로 이동되지 않습니다.
변경 전 기존 파일을 새 경로로 직접 이동해주세요.
저장 후 페이지를 새로고침해야 적용됩니다.

외부 접속 설정

외부 접속 URL (공유 링크용)

공유 링크 생성 시 사용할 외부 URL입니다. 내부망(192.168.x.x)에서 접속해도 이 주소로 공유 링크가 생성됩니다. 비워두면 현재 접속 주소를 사용합니다.

🔗 WebDAV 서버 설정

WebDAV 서버 측 설정입니다. 사용자는 사이드바 WebDAV 메뉴에서 접속 안내를 확인할 수 있습니다.

💡 사이드바 WebDAV 메뉴는 스토리지 권한 설정에서 해당 사용자에게 WebDAV 표시 권한을 활성화해야 보입니다.

⚙️ Apache 설정 (대용량 파일 전송 시 필수)

해당 사이트 VirtualHost에 추가 (경로는 설치 위치에 맞게 수정):
<LocationMatch "^/mydav\.php">
LimitRequestBody 0
</LocationMatch>
ModSecurity 사용 시 위 LocationMatch 안에 추가:
SecRuleEngine Off

⚙️ Nginx 설정 (Synology 등)

Nginx는 WebDAV 인증을 위해 Authorization 헤더를 PHP-FPM에 전달해야 합니다. server 블록에 추가하세요:
location = /mydav.php {
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root/mydav.php;
    fastcgi_param HTTP_AUTHORIZATION $http_authorization;
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_read_timeout 3600s;
    client_max_body_size 0;
}
Synology: 제어판 → Web Station → 웹 서비스 포털 → 편집 → 사용자 정의 Nginx 설정
폴더 내용이 표시되지 않으면 fastcgi_param HTTP_AUTHORIZATION 설정이 포함되어 있는지 확인하세요.

🔒 브루트포스 방지

WebDAV 로그인 시도는 data/webdav_attempts/에 기록됩니다. 5회 실패 시 해당 IP+계정이 15분간 잠금됩니다. 즉시 해제하려면 이 폴더의 JSON 파일을 삭제하세요.

로그인 화면 설정

사이트 이름

로그인 화면과 상단에 표시되는 사이트 이름입니다.

카피라이트

로그인 화면 하단에 표시되는 카피라이트 문구입니다.

로고 이미지

📁

로그인 화면에 표시되는 로고 이미지입니다. (권장: 128x128px)

로그인 배경 이미지

🖼️

로그인 화면의 배경 이미지입니다. (권장: 1920x1080px)

배경 이미지 배치

배경 이미지를 화면에 표시하는 방식입니다.

배경 이미지 필터

배경 이미지에 적용할 필터를 선택하세요.

🖼️ 썸네일 설정

썸네일 사용

그리드 뷰에서 파일 아이콘 대신 썸네일을 표시합니다. 지원 형식: 이미지(JPG/PNG/GIF/WebP/BMP), 동영상(MP4/MKV/WMV/AVI/MOV/WebM/FLV/TS/MPG 등), PDF, 오디오 앨범 커버(MP3 ID3v2 내장 이미지).

⚠️ 동영상이 많은 폴더를 탐색할 때 썸네일 생성 부하를 줄이려면 끄는 것도 방법입니다(동영상 썸네일 생성에 ffmpeg 사용).

썸네일 크기

썸네일 해상도입니다. 클수록 선명하지만 트래픽이 증가합니다.

ffmpeg / ffprobe 경로

ffmpeg

ffprobe

ffmpeg: 동영상에서 프레임을 추출하여 썸네일을 생성합니다. ffprobe: 동영상 길이/메타데이터를 읽습니다. ffmpeg 다운로드 시 함께 포함되어 있습니다. ffmpeg 다운로드 ↗

PDF 도구 경로

PDF 썸네일에 필요합니다. 우선순위: Imagick+Ghostscript → pdftoppm → mutool → gs. 비워두면 자동 감지합니다.

서버 환경

확인 중...

캐시된 썸네일을 모두 삭제합니다. 다음 조회 시 자동으로 다시 생성됩니다.

📦 압축파일 미리보기 설정

압축 파일(zip, rar, 7z, iso 등)을 미리보기하여 내부 파일 목록을 확인할 수 있습니다. ZIP과 TAR 형식은 PHP 내장으로 동작합니다. 그 외 형식(RAR, 7Z, ISO, CAB 등)은 서버에 7-Zip이 설치되어야 합니다.

PHP 내장	zip, tar, gz, tgz, bz2
7-Zip 필요	rar, 7z, iso, cab, wim, arj, lzh, dmg, msi 외 다수
UnRAR 선택	rar (7-Zip이 못 읽는 rar 파일 보완)

💡 7-Zip 설치 방법

Windows: 7-zip.org 에서 다운로드 후 기본 경로에 설치
Linux: apt install 7zip 또는 yum install p7zip-full

💡 UnRAR 설치 방법 (선택)

7-Zip으로 목록이 안 보이는 일부 rar 파일에만 필요합니다.

Windows: win-rar.com 에서 WinRAR 설치 (UnRAR.exe 포함)
Linux: apt install unrar 또는 yum install unrar

검색 인덱스 설정

인덱스 자동 갱신

웹 UI가 아닌 외부(서버에서 직접 접근, FTP, 네트워크 드라이브, 외부 동기화 도구 등)에서 파일이 추가/변경/삭제된 것을 주기적으로 감지하여 검색 인덱스와 파일 목록에 반영합니다.

웹 UI에서의 파일 작업과는 무관합니다. 웹 UI로 업로드/삭제/이름변경/이동한 파일은 이 설정과 상관없이 항상 즉시 반영됩니다.

⚠️ 파일이 매우 많은 환경에서는 비활성화하고 수동 "인덱스 재구축" 버튼을 사용하는 편이 서버 부담이 적습니다.

백그라운드 스캔 주기

백그라운드에서 주기적으로 도는 디스크 전체 스캔의 주기입니다. 폴더 이동, 스토리지 전환, 동영상이나 파일 클릭해서 열 때 가끔 웹 UI가 멈추는 현상이 있으면 이 값을 늘려서 스캔 빈도를 낮춰 주세요.

스토리지 사용량 재계산 주기 (분)

각 스토리지의 "사용 용량"을 파일 전체 스캔으로 재계산하는 주기입니다. 웹 UI로 업로드/삭제하는 파일은 이 설정과 무관하게 즉시 반영되며, 이 주기는 웹 UI 외부에서의 변경(직접 파일 추가, FTP 등) 반영에만 영향을 줍니다.

권장: 60분 (범위: 1–1440). 값을 줄이면 반영이 빠르지만 서버 부하가 늘어납니다. 용량이 크거나(10TB 이상) 느린 디스크라면 360분(6시간) 이상을 권장합니다.

검색 인덱스 동기화 주기 (분)

검색 인덱스를 파일시스템과 동기화하는 주기입니다. 웹 UI로 추가/삭제되는 파일은 이 설정과 무관하게 즉시 인덱싱되며, 이 주기는 외부 변경 감지에만 영향을 줍니다.

권장: 1440분(24시간) (범위: 1–1440). 외부 변경을 즉시 인덱스에 반영하려면 이 주기를 짧게 하기보다 수동 "인덱스 재구축" 버튼을 사용하는 편이 서버 부담이 적습니다.

⚠️ 위의 "인덱스 자동 갱신"이 켜져 있을 때만 적용됩니다.

📧 이메일(SMTP) 설정

아이디/비밀번호 찾기 기능에 사용됩니다. 설정하지 않으면 PHP mail() 함수를 사용합니다.

SMTP 사용

SMTP 호스트 Gmail: smtp.gmail.com | Naver: smtp.naver.com | Daum: smtp.daum.net

포트 TLS: 587 | SSL: 465

암호화 방식

SMTP 사용자명 보통 이메일 주소 전체

SMTP 비밀번호 Gmail: 앱 비밀번호 사용 권장 (비워두면 기존 비밀번호 유지)

발신자 이메일 비워두면 SMTP 사용자명 사용

발신자 이름 이메일에 표시될 발신자 이름

📤 테스트 이메일 발송

SMTP 설정을 저장한 후 테스트하세요.

📋 주요 이메일 서비스 SMTP 설정

서비스	호스트	포트	암호화	비고
Gmail	smtp.gmail.com	587	TLS	앱 비밀번호 필요 (2단계 인증)
Naver	smtp.naver.com	587	TLS	POP3/SMTP 사용 설정 필요
Daum/Kakao	smtp.daum.net	465	SSL	외부메일 사용 설정 필요
Outlook	smtp.office365.com	587	TLS	앱 비밀번호 권장

⚠️ Gmail 사용 시 주의

Google 계정에서 2단계 인증을 활성화하세요.
앱 비밀번호를 생성하여 SMTP 비밀번호로 사용하세요.
일반 비밀번호는 보안 정책으로 차단됩니다.

📝 OnlyOffice 설정

OnlyOffice 연동 활성화

활성화하면 문서 파일을 OnlyOffice로 편집할 수 있습니다.

Document Server URL

OnlyOffice Document Server의 URL입니다. HTTPS 리버스 프록시 사용 시: https://도메인/oo

설치된 서버 버전

OnlyOffice Document Server의 버전을 확인합니다. PDF 편집은 8.1 이상에서만 가능합니다. 낮은 버전에서는 PDF가 내장 pdf.js 뷰어(미리보기 전용)로만 열립니다. 먼저 연결 설정을 저장한 뒤 버전을 확인하세요.

JWT 시크릿 키 (선택사항)

Docker 실행 시 JWT_SECRET을 설정했다면 동일한 값을 입력하세요. JWT_ENABLED=false로 설치했다면 비워두세요.

🔑 JWT 시크릿 키 확인 방법

1. Docker 환경변수에서 확인

docker inspect [컨테이너명] | grep JWT_SECRET

2. 컨테이너 내부 설정 파일에서 확인

docker exec [컨테이너명] cat /etc/onlyoffice/documentserver/local.json | grep secret

3. 실행 중인 컨테이너의 환경변수 전체 확인

docker exec [컨테이너명] env | grep JWT

콜백 URL (선택사항)

OnlyOffice 서버가 이 웹하드에서 파일을 가져올 때 사용하는 URL입니다. 비워두면 현재 접속 주소를 자동 사용합니다.
※ Docker 사용자: 문서 열기 시 "다운로드 실패"가 발생하면, OnlyOffice Docker가 외부 도메인에 접근하지 못하는 것입니다. Docker가 접근 가능한 IP를 입력하세요:
  • 같은 서버: http://172.17.0.1 (Docker → 호스트 접근용)
  • 다른 서버: http://서버내부IP (예: http://192.168.0.10)
  • 게이트웨이 확인: docker network inspect bridge | grep Gateway

📋 OnlyOffice 설치 방법 (Docker)

# JWT 보안 사용 (권장)
docker run -d -p 8080:80 --restart=always \
  --shm-size=256m \
  -e JWT_SECRET=your-secret-key \
  onlyoffice/documentserver

# JWT 비활성화 (간단 설치)
docker run -d -p 8080:80 --restart=always \
  --shm-size=256m \
  -e JWT_ENABLED=false \
  onlyoffice/documentserver

🔒 Apache 리버스 프록시 설정

웹하드 도메인의 SSL(443) 설정 파일에서 </VirtualHost> 바로 위에 추가하세요.
(예: httpd-vhosts.conf 또는 httpd-ssl.conf)

# WebSocket 프록시RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule ^/oo/(.*) ws://OnlyOffice내부IP:8080/$1 [P,L]

# OnlyOffice 리버스 프록시<Location /oo/>
    ProxyPass http://OnlyOffice내부IP:8080/
    ProxyPassReverse http://OnlyOffice내부IP:8080/
    ProxyPreserveHost On
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-Host "도메인"
</Location>

# 캐시 프록시<Location /cache/>
    ProxyPass http://OnlyOffice내부IP:8080/cache/
    ProxyPassReverse http://OnlyOffice내부IP:8080/cache/
</Location>

# 인쇄 PDF 프록시 (OnlyOffice 9.3.1+ 인쇄 기능 필수)<Location /printfile/>
    ProxyPass http://OnlyOffice내부IP:8080/printfile/
    ProxyPassReverse http://OnlyOffice내부IP:8080/printfile/
</Location>

※ OnlyOffice내부IP → 서버IP 또는 Docker IP로, 도메인 → 실제 도메인으로 변경하세요. 설정 후 Apache 재시작 필요.
※ /printfile/ 블록은 OnlyOffice 편집기의 "파일 → 인쇄" 기능에 필수입니다 (인쇄 시 같은 도메인의 /printfile/... 경로 호출).

🖥️ 시놀로지 DSM 리버스 프록시 설정

DSM → 제어판 → 로그인 포탈 → 고급 → 역방향 프록시 (또는 응용 프로그램 포탈 → 역방향 프록시)

★ 방법1 (권장) - 서브도메인 방식

# 소스
프로토콜: HTTPS
호스트명: oo.도메인.com
포트: 443

# 대상
프로토콜: HTTP
호스트명: localhost
포트: 8080

※ Document Server URL → https://oo.도메인.com
※ DNS에 oo.도메인.com A레코드 추가 (같은 IP)
※ SSL 인증서에 oo.도메인.com 추가 (DSM → 보안 → 인증서)
※ 사용자 지정 헤더 탭에서 추가: Upgrade → $http_upgrade, Connection → Upgrade (WebSocket 지원)
※ 서브도메인 방식은 /printfile/, /cache/ 포함 모든 경로를 프록시하므로 인쇄 기능에 추가 설정 불필요.

▸ 방법2 - 서브패스 (/oo) — Apache에서만 권장

# 소스: HTTPS / 도메인.com / 443 / 경로: /oo
# 대상: HTTP / localhost / 8080
→ Document Server URL: https://도메인.com/oo
⚠️ 시놀로지 DSM Nginx에서 리다이렉트 문제(404) 발생 가능, /printfile/ /cache/ 경로 별도 프록시 항목 필요

🟢 Nginx 리버스 프록시 설정

OnlyOffice 서브도메인용 서버 블록을 추가하세요.

server {
    listen 443 ssl;
    server_name oo.도메인.com;

    ssl_certificate /인증서/경로/cert.pem;
    ssl_certificate_key /인증서/경로/key.pem;

    location / {
        proxy_pass http://OnlyOffice내부IP:8080/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        proxy_connect_timeout 300;
        proxy_send_timeout 300;
        proxy_read_timeout 300;
        proxy_buffering off;
        client_max_body_size 100m;
    }
}

※ Document Server URL → https://oo.도메인.com
※ DNS에 oo.도메인.com A레코드 추가
※ 같은 서버면 OnlyOffice내부IP 대신 127.0.0.1 사용
※ location / 가 /printfile/, /cache/ 포함 모든 경로를 프록시하므로 인쇄 기능에 추가 설정 불필요.

지원 파일: docx, xlsx, pptx, doc, xls, ppt, odt, ods, odp, txt, csv, html 등 (PDF 편집은 서버 8.1+ 필요)

⬆️ OnlyOffice Docs 버전 업그레이드 방법 (Docker)

서버 버전이 8.1 미만이라 PDF 편집이 안 되면 Document Server를 업그레이드하세요. 데이터 볼륨을 마운트해 두면 문서/설정 유실 없이 업그레이드됩니다.

# 1) 마운트된 데이터 백업 (볼륨 마운트 시)docker stop onlyoffice
docker rename onlyoffice onlyoffice-old   # 롤백용으로 기존 컨테이너 보존
# 2) 최신 이미지 받기
docker pull onlyoffice/documentserver:latest

# 3) 새 컨테이너 실행 (기존과 동일한 -v 마운트 / -e JWT_SECRET / -p 사용)
docker run -d -p 8080:80 --restart=always \
  --shm-size=256m \
  -e JWT_SECRET=your-secret-key \
  -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
  -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
  --name onlyoffice \
  onlyoffice/documentserver:latest

# 4) 부팅 완료(1~2분) 후 위의 "버전 확인" 클릭.# 5) 정상 확인되면 기존 컨테이너 삭제:  docker rm onlyoffice-old

※ JWT_SECRET, 포트, -v 마운트 경로는 반드시 현재 컨테이너와 동일하게 사용하세요 — 다르면 설정/데이터 또는 JWT 인증이 깨질 수 있습니다.
※ latest 대신 특정 버전으로 고정하려면 태그를 쓰세요. 예: onlyoffice/documentserver:9.3.1.
※ 기존에 데이터 볼륨을 마운트하지 않았다면 먼저 백업하세요 (ONLYOFFICE 업데이트 가이드 참고).

🔄 동기화 / 백업

스토리지 간 파일을 동기화하거나 백업합니다.

💾 설정 백업 / 복원

사용자, 스토리지, 권한, 시스템 설정을 백업하거나 복원합니다. (실제 파일은 포함되지 않습니다)

📋 수동 백업

FileStation 설치 경로의 data/ 폴더를 통째로 복사해도 백업됩니다.
실제 파일을 백업하려면 개인폴더(users/)와 공유폴더(shared/)도 함께 복사하세요.
백업 제외 항목: *.lock, file_index.db, trash_files/, *.log

🏷️ 라벨 오버레이 위치 (CSS 오버레이 모드 아이콘에만 적용)

클릭하면 즉시 적용됩니다.

로딩 중...

-개 확장자 | 🎨 = 사용자 변경됨 | 하단 버튼으로 저장 필요

작업 이름

모드

원본 스토리지 ▸ 비우면 = 스토리지 전체 동기화
▸ 특정 폴더만 하려면: /폴더명 입력

대상 스토리지 ▸ 비우면 = 스토리지 최상위에 저장
▸ 특정 폴더에 저장하려면: /폴더명 입력

원본에 없는 파일 삭제 하위 폴더 포함

🕐 자동 예약 (cron) ※ 예약 설정만 저장됩니다. 실제 자동 실행은 서버의 작업 스케줄러(Windows) 또는 crontab(Linux)에 sync_cron.php를 등록해야 합니다. 아래 가이드를 참고하세요.

💡 서버 설정 가이드 (클릭하여 펼치기)

📌 동작 원리: cron이 매분 sync_cron.php를 실행하고, 예약 시간이 맞는 작업만 실행합니다. 예약 시간이 아니면 즉시 종료되어 부하가 없습니다.

🐧 리눅스 (Ubuntu/Debian/CentOS)

# crontab 편집기 열기
crontab -e

# 아래 줄 추가 (경로를 FileStation 위치로 변경):
* * * * * php /var/www/html/filestation/sync_cron.php >> /var/log/filestation_sync.log 2>&1

# 확인
crontab -l

🪟 윈도우 (Apache/Nginx/IIS)
Windows 작업 스케줄러를 사용합니다:

# 방법 1: 작업 스케줄러 (GUI)
# 1. "작업 스케줄러" 열기 (taskschd.msc)
# 2. 기본 작업 만들기 → 이름: "FileStation Sync"
# 3. 트리거: 매일, 1분마다 반복
# 4. 동작: 프로그램 시작
#    프로그램: C:\php\php.exe
#    인수: C:\Apache24\htdocs\filestation\sync_cron.php
#    시작 위치: C:\Apache24\htdocs\filestation

# 방법 2: 명령줄 (관리자 권한으로 실행)
schtasks /create /tn "FileStation Sync" /tr "C:\php\php.exe C:\Apache24\htdocs\filestation\sync_cron.php" /sc minute /mo 1

# 방법 3: PowerShell (관리자 권한으로 실행)
$action = New-ScheduledTaskAction -Execute "C:\php\php.exe" -Argument "C:\Apache24\htdocs\filestation\sync_cron.php" -WorkingDirectory "C:\Apache24\htdocs\filestation"
$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date) -RepetitionInterval (New-TimeSpan -Minutes 1)
Register-ScheduledTask -TaskName "FileStation Sync" -Action $action -Trigger $trigger -RunLevel Highest

# 삭제:
schtasks /delete /tn "FileStation Sync" /f

⚠️ php.exe 경로를 확인하세요. where php로 확인 가능.

🐳 리눅스 Docker

# 방법 1: 호스트 crontab (권장)
crontab -e
* * * * * docker exec filestation php /var/www/html/sync_cron.php >> /var/log/filestation_sync.log 2>&1

# 방법 2: 컨테이너 내부에서
docker exec -it filestation bash
apt-get update && apt-get install -y cron
echo "* * * * * php /var/www/html/sync_cron.php >> /var/log/sync.log 2>&1" | crontab -
service cron start

# 방법 3: docker-compose에 cron 사이드카 추가
# services:
#   filestation-cron:
#     image: php:8.3-cli
#     volumes:
#       - ./filestation:/var/www/html
#     entrypoint: /bin/sh -c "while true; do php /var/www/html/sync_cron.php; sleep 60; done"

🐳 윈도우 Docker (Docker Desktop)

# 방법 1: 윈도우 작업 스케줄러 + docker exec
schtasks /create /tn "FileStation Sync" /tr "docker exec filestation php /var/www/html/sync_cron.php" /sc minute /mo 1

# 방법 2: PowerShell 스크립트 (sync_scheduler.ps1로 저장)
while ($true) {
    docker exec filestation php /var/www/html/sync_cron.php
    Start-Sleep -Seconds 60
}
# 실행: Start-Process powershell -ArgumentList "-File sync_scheduler.ps1" -WindowStyle Hidden

# 방법 3: docker-compose 사이드카 (리눅스 Docker 방법 3과 동일)

🔍 동작 확인:
php sync_cron.php --list — 전체 작업 목록
php sync_cron.php --task=1 — 1번 작업 테스트 실행
로그 파일에서 출력을 확인하세요.

🔔 재구축 알림
경과 시 관리자에게 알림 표시

검색 인덱스를 사용하면 파일 검색 속도가 대폭 향상됩니다. 파일이 많은 경우 재구축에 시간이 걸릴 수 있습니다.

⚙️ 요구사항: PHP sqlite3 확장 (extension=sqlite3)

인덱스 현황

총 항목	-
파일	-
폴더	-
마지막 재구축	-
마지막 자동 동기화	-

📋 인덱스 대상
• 수동 재구축: 개인폴더, 공유폴더, 로컬, FTP/SFTP, SMB/CIFS
• 자동 갱신: 개인폴더, 공유폴더, 로컬만 해당
※ FTP/SFTP/SMB는 네트워크 부하로 자동 갱신에서 제외됩니다.
🔍 검색
• 통합 검색: 빠름 (인덱스) — 인덱스 구축된 스토리지만
• 필터 검색: 실시간 (인덱스 불필요) — 파일 많으면 느림
※ 인덱스 재구축 시 모든 스토리지가 통합 검색에 포함됩니다.

시간	유형	사용자	파일/경로	크기	IP

일 이전

	사용자	시간	IP	국가	디바이스	결과

게시판 이름

아이콘 (이모지)

설명

목록 보기 권한

읽기 권한

글쓰기 권한

댓글 허용

첨부파일 허용 확장자 쉼표로 구분. 비어있으면 모두 허용 예) jpg,png,gif,pdf,zip,hwp,doc,docx,xls,xlsx 🔒 항상 차단: php, phtml, php3~7, phar, phps, jsp, jspx, asp, aspx, cgi, htaccess, user.ini

게시글 목록 수

페이지 네비 수

댓글 목록 수

댓글 네비 수

N 배지 표시 시간 (시간, 0=꺼짐)

📍 현재 접속 정보: IP: - | 국가: -

차단 기능 활성화

⚠️ 활성화만으로는 차단되지 않습니다! 아래 차단 모드를 반드시 1개 이상 선택하세요.

차단 모드 ※ 필수 선택

🚫 특정 국가 차단 ✅ 특정 국가만 허용

🚫 특정 IP 차단 ✅ 특정 IP만 허용

💡 국가 차단 + IP 차단을 함께 사용하면 두 조건 모두 적용됩니다.

🌐 GeoIP 데이터 소스

🌐 외부 API 📦 MMDB (권장) 📂 DAT (레거시) 📄 CSV 파일

🚫 국가 확인 불가(UNKNOWN) IP 차단

⚠️ GeoIP DB가 없거나 찾을 수 없는 IP는 UNKNOWN으로 표시됩니다.

🚫 차단할 국가 (국가 코드, 쉼표 구분)

예: CN(중국), RU(러시아), KP(북한), VN(베트남)

✅ 허용할 국가 (국가 코드, 쉼표 구분)

예: KR(한국), US(미국), JP(일본)

🚫 차단할 IP (줄바꿈 또는 쉼마 구분, CIDR 지원)

✅ 허용할 IP (줄바꿈 또는 쉼마 구분, CIDR 지원)

⭐ 관리자 IP (화이트리스트)

⚠️ 차단 설정 전 반드시 관리자 IP를 입력하세요!
이 IP는 모든 차단 규칙을 무시하고 항상 접근이 허용됩니다.
현재 접속 IP: - ← 이 IP를 아래에 추가하세요!

줄바꿈 또는 쉼마로 구분, CIDR 지원 (예: 192.168.1.0/24)

차단 메시지

IP→국가 캐시 시간

시간

차단 로그 로그 기록

🌍 국가 코드 참조 펼치기/접기

허용 국가 선택 차단 국가 선택

아시아 (27)

중앙아시아 (8)

중동 (16)

유럽 (50)

북미 (38)

남미 (14)

오세아니아 (25)

아프리카 (58)

기타 (14)

🔐 브루트포스 방지

최대 로그인 시도 0 = 비활성화

시도 횟수 리셋 (분) 이 시간 후 시도 횟수 초기화

잠금 시간 (분) 0 = 무제한 (수동 해제 필요)

무제한 잠금 (관리자 수동 해제 필요)

📋 최근 차단 로그

기간: ~

로딩 중...

🔐 브루트포스 로그

기간: ~

로딩 중...

⚠️ 서버 백신 검사

업로드되는 파일을 서버에 설치된 백신으로 검사합니다.
클라이언트 PC의 백신과는 별개로 동작합니다.
⏱️ 백신 검사로 인해 업로드 완료가 지연될 수 있습니다.

검사 엔진

최대 검사 파일 크기 (MB) 0 = 무제한. 이 크기를 초과하는 파일은 검사를 건너뜁니다.

백신 오류 시 업로드 차단 활성화하면 백신 검사 오류 시 업로드가 차단됩니다. 비활성화하면 오류 시 업로드를 허용합니다.

📋 검사 로그

시작:

종료:

🔐 랜섬웨어 방지 기능
의심스러운 파일 업로드 차단, 대량 작업 감지, 파일 버전 관리로
랜섬웨어로부터 데이터를 보호합니다.

🚫 의심 확장자 차단

의심 확장자 업로드 차단

차단할 확장자 목록 쉼표(,)로 구분. 랜섬웨어가 생성하는 확장자를 입력하세요.

의심스러운 랜덤 확장자 차단 (숫자+문자 조합 6자 이상)

⚠️ 대량 작업 감지 및 차단

대량 작업 보호 활성화

감지 시간 (초) 이 시간 내에 대량 작업 감지

삭제 임계값 (개) 이 수 이상 삭제 시 차단

덮어쓰기 임계값 (개) 이 수 이상 덮어쓰기 시 차단

차단 시간 (분) 차단 후 이 시간 동안 작업 금지

📦 파일 버전 관리

덮어쓰기 시 이전 버전 자동 백업

버전 보관 기간 (일) 이 기간 후 이전 버전 자동 삭제

최대 버전 수 (파일당) 파일당 보관할 최대 버전 수

버전 관리 제외 확장자 쉼표(,)로 구분. 버전 관리하지 않을 확장자

🔍 파일 내용 검사

파일명이 정상이어도 내용이 암호화된 파일을 감지합니다.

파일 내용 검사 활성화

파일 시그니처 검사 파일 헤더(매직 바이트)가 확장자와 일치하는지 확인합니다.

시그니처 불일치 시 차단 체크 해제 시 경고 로그만 기록합니다.

📋 랜섬웨어 방지 로그

📤 업로드 파일 유형 제한
사용자가 업로드할 수 있는 파일 유형을 제어합니다. 허용 목록 또는 차단 목록 방식을 선택하세요.

🔒 항상 차단 (서버 실행 파일): php, phtml, php3~7, phar, phps, jsp, jspx, asp, aspx, cgi, htaccess, user.ini — 설정과 관계없이 업로드할 수 없습니다.

📋 업로드 제한 방식

*.* — 모든 파일 허용 (제한 없음) 지정한 확장자만 허용 (화이트리스트) 지정한 확장자 차단 (블랙리스트)

🔍 MIME 타입 검증

파일 내용과 확장자 일치 여부 검증 (위장 파일 방지) 활성화하면 확장자와 실제 내용이 다른 파일을 차단합니다 (예: exe를 jpg로 변경한 파일)

📏 최대 파일 크기

MB (0 = 무제한. 청크 업로드와 무관하게 개별 파일 크기를 제한합니다)

오늘 접속

0

(0명)

어제 접속

0

(0명)

최근 7일

0

(0명)

최근 30일

0

(0명)

* 오늘 시간대별 접속 현황

날짜	로그인 수	사용자 수

* 최근 30일간 기록

월	로그인 수	사용자 수

* 최근 12개월 기록

년도	로그인 수	사용자 수

* 로그인 사용자 기준, 봇 제외 / 괄호 안은 순 방문자 수

회원 탈퇴 또는 관리자가 삭제한 사용자 기록입니다.

자동 삭제 일 경과 시 자동 삭제

아이디	역할	가입일	유형	삭제일	처리자	로그	파일	관리

📋 팝업 관리 로그인 후 왼쪽 상단에 표시 (최대 10개)

📣 상단 배너 파일 목록 상단에 표시되는 한 줄 공지

✅ 활성화	배너 활성화
📝 배너 내용
🔗 링크 (선택)	클릭 시 이동할 URL (비워두면 클릭 불가)
📅 시작일	비워두면 즉시 시작
📅 종료일	비워두면 무기한
🎨 배경색
🎨 글자색
👁️ 미리보기	배너 내용이 여기에 표시됩니다

📝 제목

📄 내용 (HTML 지원)

🖼️ 이미지 URL

📤 이미지 업로드 jpg, png, gif, webp (최대 2MB)

🖼️ 현재 이미지

👁️ 표시 방식

📅 시작일 비워두면 즉시 시작

📅 종료일 비워두면 무기한

↔️ 가로 크기 (px)

↕️ 세로 크기 (px)

📍 위치 X (px)

📍 위치 Y (px)

💡 비워두면 자동 배치. X/Y를 입력하면 해당 위치에 고정 표시됩니다.

🎨 헤더 배경색

✅ 팝업 활성화

📄 파일: -

⏳

버전 목록을 불러오는 중...

Kerberos/SPNEGO 자동 로그인 활성화 AD 조인된 Windows PC에서 ID/PW 입력 없이 자동 로그인됩니다. Apache mod_auth_kerb(Linux) 또는 IIS Windows 인증이 필요합니다.

계정 자동 생성 첫 로그인 시 FileStation 계정 자동 생성

기본 역할

💡 Apache 서버 설정 가이드

1. mod_auth_kerb 설치 (Apache 2.4 Windows)

# httpd.conf
LoadModule auth_kerb_module modules/mod_auth_kerb.so

2. Apache VirtualHost 또는 Directory 설정

<Location /api.php>
    AuthType Kerberos
    AuthName "FileStation SSO"
    KrbAuthRealms YOUR.DOMAIN.COM
    KrbServiceName HTTP/filestation.your.domain.com
    Krb5Keytab C:/Apache24/conf/http.keytab
    KrbMethodNegotiate On
    KrbMethodK5Passwd Off
    # Require valid-user  ← 주석 처리: PHP에서 선택적 처리
</Location>

3. AD에서 SPN 및 keytab 생성

# AD 서버에서 실행 (PowerShell)
setspn -S HTTP/filestation.your.domain.com DOMAIN\ServiceAccount
ktpass -princ HTTP/filestation.your.domain.com@YOUR.DOMAIN.COM ^
  -mapuser DOMAIN\ServiceAccount -pass * ^
  -out C:\http.keytab -crypto AES256-SHA1 -ptype KRB5_NT_PRINCIPAL

4. 브라우저 설정 (IE/Edge/Chrome)

사이트를 로컬 인트라넷 영역에 추가하거나 GPO로 자동 Kerberos 인증을 설정하세요.

# Chrome/Edge GPO 정책
AuthServerAllowlist: *.your.domain.com
AuthNegotiateDelegateAllowlist: *.your.domain.com

LDAP/AD 인증 활성화

사용자가 Active Directory 또는 LDAP 계정으로 로그인할 수 있습니다. 아래에 AD/LDAP 서버 정보를 입력하세요.

서버 주소

포트

Base DN

Bind DN

Bind Password

사용자 필터

사용자명 속성

이메일 속성

표시이름 속성

버튼 텍스트

LDAPS (TLS) STARTTLS 자동 계정 생성

OpenID Connect 활성화

Azure AD, Google, Keycloak 등과 연동합니다. Well-Known URL을 입력하면 엔드포인트가 자동 입력되며, 수동 입력도 가능합니다.

Well-Known URL (자동 설정)

Well-Known URL을 입력하면 아래 엔드포인트가 자동 입력됩니다

제공자 이름

Client ID

Client Secret

Redirect URI

Authorization Endpoint

Token Endpoint

UserInfo Endpoint

Scope

버튼 텍스트

자동 계정 생성 자동 로그인 (IdP에 이미 인증된 경우 로그인 화면 없이 자동 진입)

SAML 2.0 활성화

SAML 2.0 IdP(Azure AD, Okta, ADFS 등)와 연동합니다. IdP 정보를 입력하고, 하단의 SP Metadata URL을 IdP에 등록하세요.

IdP (Identity Provider) 설정

IdP SSO URL

IdP 인증서 (X.509 PEM)

SP (Service Provider) 설정

SP Entity ID

SP ACS URL

버튼 텍스트

자동 계정 생성

📄 SP Metadata URL: api.php?action=sso_saml_metadata

FileStation

FileStation

아이디 찾기

비밀번호 찾기

회원가입

새 폴더

🔒 암호화 폴더 생성

🔐 암호화 폴더 잠금 해제

스토리지 추가

👥 사용자 권한

📁 폴더별 권한

공유 링크 생성

👤 사용자에게 공유

👤 내 사용자 공유

👤 사용자 공유 관리

📨 나에게 공유됨

이름 변경

💾 스토리지 관리

사용자 관리

💾 일괄 용량 설정

사용자 추가

🚫 정지 기간 설정

🔧 부 관리자 접근 권한

🏷️ 역할 관리

⚡ 속도 제한 설정

🔗 공유 관리

⚙️ 설정

👤 내 정보

🌐 언어

정보 수정

비밀번호 변경

⚠️ 회원 탈퇴

ℹ️ 회원 탈퇴

🔐 2단계 인증 (TOTP)

⚙️ 관리자 TOTP 설정

1. 인증 앱에서 QR 코드를 스캔하세요

2. 인증 앱에 표시된 6자리 코드를 입력하세요

🔑 앱 비밀번호

🎨 테마

🕐 시계 스타일

📱 활성 세션

📋 최근 로그인 기록

🔧 시스템 설정

일반 설정

스토리지 경로 설정

외부 접속 설정

🔗 WebDAV 서버 설정

로그인 화면 설정

🖼️ 썸네일 설정

📦 압축파일 미리보기 설정

검색 인덱스 설정

백그라운드 스캔 주기

📧 이메일(SMTP) 설정

📤 테스트 이메일 발송

📋 주요 이메일 서비스 SMTP 설정

📝 OnlyOffice 설정

🔄 동기화 / 백업

💾 설정 백업 / 복원

🎨 확장자 아이콘 관리

🔄 동기화 / 백업

📋 동기화 로그

🔍 검색 인덱스

인덱스 현황

📜 활동 로그

🧹 조건부 일괄 삭제

검색 결과

권한 설정

권한 추가

📄 상세 정보

파일 정보

📋 전체 로그인 기록

📋 게시판 관리

📋 게시판 추가

📂 스토리지에서 선택

🗑️ 전체 휴지통

🗑️ 내 휴지통

🛡️ IP/국가 차단 설정

차단 모드 ※ 필수 선택

🌐 GeoIP 데이터 소스

⭐ 관리자 IP (화이트리스트)