사용자·그룹·마운트 포인트

파일질라 서버 1.x에서 "누가 들어올 수 있고, 들어와서 어떤 폴더를 볼 수 있는지"는 세 가지로 정합니다.

• 사용자(User) — 접속하는 사람(또는 복합기) 한 명 한 명의 계정
• 그룹(Group) — 여러 사용자에게 같은 폴더·제한을 한 번에 주는 묶음 (없어도 됨)
• 마운트 포인트(Mount point) — "사용자에게 보이는 경로"와 "서버 PC의 실제 폴더"를 잇는 설정

💡 결론부터:

• 사용자는 Server > Configure(Ctrl+F) → Rights management > Users → [Add]로 만듭니다.
• 사용자를 만들었으면 마운트 포인트를 꼭 하나 이상 넣으세요. 없으면 로그인은 돼도 보이는 폴더가 없습니다.
• 가장 흔한 설정: 가상 경로 / ↔ 실제 경로 D:\FTP, 권한 Read + Write.
• 사람이 몇 명 안 되면 그룹 없이 사용자만 만들어도 충분합니다.

🙋 옛 블로그처럼 폴더마다 "파일 읽기·쓰기·삭제, 폴더 만들기…" 체크 상자를 찾고 있나요? 그건 0.9.x 방식입니다. 1.x는 폴더를 공유하는 방식 자체가 마운트 포인트로 바뀌었어요. → 0.9.x와 1.x 차이

준비물

• 파일질라 서버 1.x가 설치되어 있고, 관리 화면이 서버에 연결된 상태 → 설치부터 첫 접속까지
• 공유할 폴더를 정해 두기 (예: D:\FTP)

1단계 — 사용자 목록 열기

관리 화면에서 Server > Configure...(Ctrl+F) → 왼쪽 목록 Rights management > Users를 고릅니다.

사진을 누르면 크게 볼 수 있어요

1. 11. <system user> — 설치 직후 유일한 사용자, 꺼져 있음
2. 22. User is enabled — 체크 안 됨(꺼짐)
3. 33. [Add] 새 사용자
4. 44. [Remove] 삭제
5. 55. [Duplicate] 복사해서 새로
6. 66. [Rename] 이름 바꾸기

설치 직후 목록에는 <system user>라는 특수 사용자만 있고, 꺼져 있습니다. 설치했을 때 접속 가능한 사용자가 하나도 없도록 일부러 그렇게 되어 있습니다. 무료판 1.12.6의 목록에는 <system user> 하나만 있습니다(Active Directory용 사용자는 없음, 실측).

• <system user>는 무엇? 목록에 없는 이름으로 로그인하면 윈도우 계정 정보로 확인해 주는 대체 사용자입니다. 이름 변경·복제·삭제가 안 됩니다. 윈도우 계정으로 로그인시킬 생각이 없다면 꺼진 그대로 두세요.

2단계 — 사용자 만들기 (General 탭)

[Add]를 누르면 목록에 New User가 생기고 이름을 바로 고칠 수 있습니다. 사용자 이름을 입력하고 Enter를 누릅니다. 예: ftpuser. (처음 한 번은 Warning: Setting Up Native Paths 알림이 뜹니다. [OK]를 누르면 됩니다.) 오른쪽 General 탭에서 아래를 정합니다.

사진을 누르면 크게 볼 수 있어요

1. 11. User is enabled
2. 22. Authentication — 인증 방식
3. 33. 비밀번호 칸 — 저장 뒤엔 'Leave empty to keep existing password'
4. 44. Member of groups — 그룹 고르기(4단계)
5. 55. Mount points 표 — / ↔ C:\FTP
6. 66. Mount options — 선택한 줄의 권한·옵션

User is enabled — 사용자 켜기

• 체크: 이 사용자가 접속할 수 있습니다.
• 해제: 접속이 거부됩니다. 접속 중이던 세션도 즉시 끊깁니다. 잠깐 막고 싶을 때 삭제 대신 이걸 끄면 됩니다.

인증 방식 (Authentication) — 로그인할 때 무엇을 확인할지

• 무료판 드롭다운의 선택지는 위 세 가지입니다(실측). Active Directory 로그인은 유료 Pro Enterprise Server에만 있습니다.
• 새 사용자는 보안을 위해 기본이 "비밀번호 필요"입니다. 비밀번호는 드롭다운 바로 아래 칸에 넣습니다. 저장한 뒤에는 이 칸에 Leave empty to keep existing password(비워 두면 기존 비밀번호 유지)가 흐리게 보입니다. 비밀번호는 안전한 방법으로 전달하세요.
• Use system credentials to log in에서 Use system credentials also for accessing files and directories까지 켜면, 그 윈도우 계정의 파일 권한을 그대로 물려받습니다. 마운트 포인트로 추가 제한은 할 수 있습니다.
• Do not require authentication은 공식 FAQ의 "익명 로그인" 방법입니다. 이름을 anonymous로 만들고 이 방식을 고르면 됩니다. ⚠️ 누구나 들어올 수 있으니 Read only 권한과 함께만 쓰세요.

3단계 — 마운트 포인트 (가장 중요)

마운트 포인트란?

사용자는 서버 PC의 C:\FTP 같은 실제 폴더 이름을 보지 못합니다. 대신 /, /reports 같은 가상 경로를 봅니다. 마운트 포인트는 이 둘을 잇는 표입니다.

General 탭의 Mount points 표 아래 [Add]를 눌러 한 줄씩 추가합니다. 새 줄의 Virtual path 칸이 바로 입력 상태가 되고, Enter를 누르면 Native path 칸으로 넘어갑니다. 표에서 줄을 고르면 오른쪽 Mount options에 그 줄의 권한과 옵션이 나옵니다.

사진을 누르면 크게 볼 수 있어요

1. 11. 고른 마운트 줄
2. 22. Access mode — Disabled / Read only / Write only / Read + Write

🙋 한국어 윈도우에서는 표에 C:\FTP가 C:₩FTP로 보입니다. \와 ₩는 같은 글자라 그대로 두면 됩니다.

가장 흔한 예 — 폴더 하나를 통째로 보여 주기

이렇게 하면 접속하자마자 맨 위(/)에 C:\FTP의 내용이 바로 보입니다. C:\FTP 안에 reports, invoices 폴더가 있으면 사용자는 /reports, /invoices를 봅니다.

여러 폴더를 보여 주기

마운트 포인트를 여러 줄 추가하면 됩니다. 공식 FAQ의 예처럼 D:\mypictures를 /pictures로 보여 줄 수 있습니다.

권한 네 가지

• Read + Write에서 Writable directory structure를 끄면 파일은 올릴 수 있지만 하위 폴더를 만들거나 지우거나 이름을 바꿀 수 없습니다.
• Apply permissions to subdirectories(하위 폴더에도 적용)는 새 줄에서 기본으로 켜져 있습니다. 끄면 하위 폴더는 모두 Disabled(접근 불가)가 됩니다.
• Write only는 공식 버전 기록 기준으로 1.11.0에서 들어온 모드입니다.

하위 폴더 하나만 막는 방법 (Disabled)

/docs는 보여 주되 그 안의 /docs/private만 막고 싶다면:

Disabled 줄의 실제 경로는 무시됩니다. 잠깐 막아 두고 싶은 마운트 포인트를 Disabled로 바꿔 두는 용도로도 쓸 수 있습니다.

사용자마다 자동으로 다른 폴더 — 플레이스홀더

사용자가 많을 때는 실제 경로에 플레이스홀더(자리표시자)를 쓰면 편합니다.

그룹에 / ↔ D:\FTP\%<user>를 한 번만 넣어 두면, 그룹에 속한 사람마다 자기 폴더만 보게 됩니다(4단계).

⚠️ 비밀번호로 로그인하는 사용자에게 %<home>을 쓰면 저장할 때 Error on row number 1: placeholders expansion for the native path has issues / Placeholder %<home> can be used only for users whose authentication is set to "Use system credentials to log in" 오류가 나고 저장되지 않습니다(실측). 이때는 C:\FTP\%<user>처럼 실제 폴더를 적으세요.

폴더가 아직 없다면

Create native directory if it does not exist를 체크하면(기본은 꺼짐) 서버가 실제 폴더를 만들어 줍니다. 플레이스홀더를 쓸 때 특히 편합니다.

⚠️ "Virtual path / Native path is invalid" 오류가 나요. 흔한 원인은 세 가지입니다.

1. 가상 경로에 \나 D:를 넣었다 → 가상 경로는 /로만
2. 전체 경로가 아니다 → FTP 말고 D:\FTP, scan 말고 /scan
3. 실제 경로가 드라이브 문자나 \\로 시작하지 않는다

그리고 실제 폴더가 있는지, 없으면 위 체크 상자를 켰는지 확인하세요.

🙋 윈도우 폴더 권한도 함께 적용돼요. 마운트 포인트가 Read + Write여도, 윈도우(NTFS)에서 읽기 전용인 파일은 쓸 수 없습니다. 서버는 기본으로 서비스 실행 계정(SYSTEM)의 권한으로 파일에 접근합니다. 다른 계정으로 접근하게 하려면 Rights management 페이지의 Use other system user를 씁니다.

4단계 — 그룹 (필요할 때만)

그룹은 여러 사용자에게 같은 마운트 포인트·필터·제한을 한 번에 주는 기능입니다. 공식 문서도 대부분의 경우 그룹은 필수가 아니라고 합니다. 이럴 때 쓰세요.

• 부서 전원이 같은 공용 폴더를 써야 할 때
• 사용자마다 D:\FTP\%<user>처럼 같은 규칙의 폴더를 줄 때

그룹 만들기

Rights management > Groups → 목록(Available groups) 아래 [Add] → 이름 입력(예 staff). 오른쪽 탭(General·Filters·Limits·Protocol policies)은 사용자와 같고, General 탭에는 비밀번호 없이 Mount points만 있습니다.

사진을 누르면 크게 볼 수 있어요

1. 11. 새 그룹 staff
2. 22. / ↔ D:\FTP\%<user> — 사용자마다 자기 폴더
3. 33. /public ↔ D:\FTP\public — 모두가 같이 쓰는 폴더
4. 44. Create native directory — 폴더 자동으로 만들기

사용자를 그룹에 넣기

사용자 General 탭의 Member of groups 드롭다운을 펼치면 그룹 목록이 체크 상자로 나옵니다. 넣을 그룹을 체크하고 드롭다운 밖을 누르면 닫힙니다. 여러 그룹에 넣을 수 있고, 오른쪽 Up / Down 버튼으로 순서를 바꿉니다(위에 있는 그룹이 우선).

사진을 누르면 크게 볼 수 있어요

1. 11. staff 체크
2. 22. Up / Down — 그룹 순서 (위가 우선)

사진을 누르면 크게 볼 수 있어요

1. 11. Member of groups — staff

⚠️ 드롭다운을 닫으려고 Esc 키를 누르지 마세요. 실측해 보니 Esc가 설정 창 전체의 [Cancel]로 먹어서, 저장하지 않은 변경이 모두 사라졌습니다. 드롭다운 밖의 빈 곳을 누르세요.

설정이 겹치면 무엇이 이기나

그룹을 지울 때

사용자가 남아 있는 그룹을 [Remove] 하면 네 가지 중 하나를 고르라고 묻습니다.

⚠️ 두 번째·세 번째는 사용자가 지워집니다. 헷갈리면 첫 번째를 고르세요.

5단계 — 제한(Limits)과 IP 필터(Filters) — 선택

제한 (사용자·그룹의 Limits 탭)

예: 10 KiB/s로 정하고 세션이 5개일 때 — per-session이면 세션마다 10씩 합계 50 KiB/s, shared면 다섯 개 합쳐서 10 KiB/s입니다.

기본값은 모두 Unlimited(제한 없음)이고, 각 항목 앞의 체크 상자를 켜야 숫자를 넣을 수 있습니다(실측). 화면에서는 Speed limits shared by all sessions(모두 합쳐서), Speed limits specific to each session(세션마다), Filesystem limits specific to each session(Files·Directories), Concurrent sessions limit 순서로 나옵니다.

IP 필터 (사용자·그룹의 Filters 탭)

Disallowed IP ranges(막을 주소)와 Allowed IP ranges(허용할 주소) 두 목록이 있습니다.

• 두 목록 모두에 해당하는 주소는 허용됩니다. 둘 다 비어 있으면 필터를 쓰지 않습니다.
• 형식: 주소 하나(192.168.0.50), 구간(192.168.0.2-192.168.0.30), CIDR(192.168.0.0/24), *(0~255 전체). IPv4·IPv6 모두 됩니다.
• 서버 전체(프로토콜 수준) 필터가 사용자·그룹 필터보다 우선합니다.
• 예: 복합기(192.168.0.50)만 접속하게 하려면 → Disallowed에 0.0.0.0/0(IPv4 전체)과 ::/0(IPv6 전체), Allowed에 192.168.0.50. 두 목록에 모두 해당하는 주소는 허용되므로 복합기만 통과합니다. 두 칸은 여러 줄을 넣을 수 있는 글 상자라 한 줄에 하나씩 적습니다. 공식 KB 규칙(Disallowed에 걸리면 거부, 두 목록 모두에 걸리면 허용)대로 한 설정이지만, 저장한 뒤에는 다른 PC에서 접속해 실제로 막히는지 한 번 확인해 두세요. → 복합기 스캔을 파일질라 서버로 받기

확인

1. [OK]로 저장합니다.
2. 파일질라 클라이언트로 그 사용자로 접속해 봅니다. → 설치 13단계
3. 원격 사이트 창에 보여야 할 폴더만 보이는지, 올리기·지우기가 권한대로 되는지(Read only면 올리기가 거부되는지) 확인합니다.

자주 하는 실수

자주 묻는 질문

Q. 사용자마다 다른 폴더만 보이게 할 수 있나요? 네. 사용자마다 /를 다른 실제 폴더에 연결하면 됩니다. 사람이 많으면 그룹에 D:\FTP\%<user>를 한 번 넣는 방법이 편합니다.

Q. 0.9.x처럼 "목록 보기만 금지" 같은 세세한 권한이 있나요? 1.x에는 그런 세부 권한이 없고, 위의 네 가지 권한과 체크 상자로 정합니다. 0.9.x에서 옮겨 올 때 이 부분은 다시 점검해야 합니다.

Q. NAS나 다른 PC의 공유 폴더를 보여 줄 수 있나요? 1.11부터 Windows Shares Credentials에 공유 폴더(\\서버\공유)와 접속 계정을 등록한 뒤 실제 경로에 UNC 경로를 쓸 수 있습니다. 다만 공식 FAQ는 데이터가 두 번 오가므로 가능하면 그 기기에 서버를 직접 설치하라고 권합니다.

Q. 사용자를 지우지 않고 잠깐만 막으려면? User is enabled를 끄세요. 접속 중인 세션도 바로 끊깁니다.

참고한 공식 문서

• How to Add and Manage Users in FileZilla Server (FileZilla Pro KB)
• How to Create a User (KB)
• How to Edit Mount Points: Virtual & Native Paths (KB)
• Virtual and/or Native Path is Invalid (KB)
• FileZilla Server Group Panel (KB)
• How to Add Users to a Groups (KB)
• How to Edit Limits (KB)
• FileZilla Server Filters (KB)
• FileZilla Server Rights Management (KB)
• How to Set Up Windows Shares Credentials (KB)
• FileZilla 버전 기록 (filezilla-project.org)
• FAQ — FileZilla Server (공식 위키)

이 글의 일부는 FileZilla 위키(GFDL)를 참고해 한국어로 새로 썼습니다.

요약

한눈에 정리

1. 1사용자 = 켜기 + 비밀번호

   User is enabled 체크, 인증 방식 Require a password.

2. 2마운트 포인트가 핵심

   가상 경로 / ↔ 실제 폴더(C:\FTP). 없으면 폴더가 안 보여요.

3. 3권한은 네 가지

   Read only · Read + Write · Write only · Disabled 중에서 골라요.

4. 4여럿이면 그룹

   그룹에 %<user> 폴더를 넣으면 사람마다 자기 폴더만 보여요.

최종 수정 2026-09-25