사용 가이드
ZIPN 서비스를 쉽게 사용하는 방법을 안내합니다.
1. 비회원 URL 단축
메인 페이지에서 바로 URL을 단축할 수 있습니다.
- 원본 URL을 입력합니다.
- 원하는 단축 코드를 입력합니다. (한글, 영문, 숫자 가능)
- 만료 기간을 선택합니다. (24시간, 48시간, 1주일, 1개월)
- "URL 단축하기" 버튼을 클릭합니다.
2. 텍스트 공유
메인 페이지에서 "텍스트 공유" 탭을 선택해 긴 텍스트를 단축 주소로 공유할 수 있습니다.
3. 파일 공유
문서·이미지·압축파일(ZIP 등)을 단축 주소로 공유할 수 있습니다. 모든 파일은 Cloudflare R2 스토리지로 초고속 직접 업로드됩니다. (최대 5GB 지원)
- 허용: PDF, Office, HWP, TXT/HTML/MD/CSV, 이미지(PNG/JPG/GIF/WEBP), 압축파일(ZIP/7Z/TAR/GZ/RAR) 등 (실행 파일은 ZIP 압축 권장)
- 용량별 수명 주기(보관 및 자동 삭제) 규칙:
- 10MB 이하 (일반 파일): 30일간 보관 후 자동 삭제됩니다. (비회원은 만료 기간 설정 가능, 기본 30일)
- 10MB 초과 ~ 1GB (대용량 파일): 스토리지 자원 관리를 위해 7일간 보관 후 자동 삭제됩니다.
- 1GB 초과 ~ 5GB (초대용량 파일): 대용량 자원 보호를 위해 2일간 보관 후 자동 삭제됩니다.
- 회원 파일 공유의 장점: 회원의 단축 주소는 영구 보존됩니다. 파일 보관 기간이 만료되면 다운로드가 차단되고 저장본이 삭제되지만 주소는 남습니다. 대시보드 [수정]에서 새 파일을 재등록하면 다운로드 기간이 다시 연장됩니다.
4. 회원 URL 단축 (영구)
Google로 가입한 뒤 본인 코드를 정하면, 영구적으로 유지되는 URL·텍스트를 만들 수 있습니다. (파일 공유는 단축 주소가 유지되며 위 3번의 보관 기간 및 재등록 기능 적용)
- 회원가입(Google) 또는 로그인을 합니다.
- 메인 페이지 또는 대시보드에서 단축 주소를 생성합니다.
- 생성된 URL은 "zipn.app/닉네임/코드" 형태입니다.
- 대시보드에서 모든 링크를 관리할 수 있습니다.
5. 대시보드 사용
로그인 후 대시보드에서 다음 기능을 사용할 수 있습니다:
- 새 URL·텍스트·파일 공유 생성
- 기존 목록 확인
- 각 링크의 클릭 통계 확인
- 복사·수정·삭제
- 본인 코드 변경 (30일에 한 번. 바꾸면 기존 주소는 즉시 무효가 되고 이전 코드는 바로 해제됩니다)
6. QR 코드 활용
단축 후 자동으로 QR 코드가 생성됩니다. 이 QR 코드를 수업 자료, 인쇄물, 발표 자료 등에 활용하세요.
7. 웹페이지 공유 (HTML / ZIP)
- 메인 화면에서 "웹페이지 (HTML)" 탭을 선택합니다.
- HTML 파일을 선택하거나, index.html과 CSS·JavaScript·이미지를 함께 넣은 ZIP을 올립니다. 코드 직접 입력도 가능합니다.
- 단축 코드를 정하고 "웹페이지 주소 만들기"를 누릅니다.
웹페이지는 최대 10MB이며 ZIP은 압축 해제 후에도 전체 10MB, 최대 500개 파일까지 지원합니다. index.html은 최상위 또는 하나의 공통 폴더 안에 있어야 합니다. 하위 폴더와 상대 경로, 일반적인 /assets/ 경로를 지원합니다.
React·Vite 등은 빌드한 dist 폴더를 압축해주세요. node_modules, 환경 변수(.env), 서버 실행용 소스는 제외합니다. Node.js·PHP 서버 및 서버 렌더링은 실행하지 않습니다. SPA는 해시 라우팅을 사용해주세요.
ZIP 웹페이지는 로그인 정보를 보호하기 위해 격리된 환경에서 실행됩니다. 쿠키·localStorage·서비스 워커를 사용할 수 없으며 외부 API는 CORS를 허용해야 합니다. 회원 영구 주소는 삭제 전까지 보관되며, 임시 주소는 선택한 기간 이후 만료됩니다. 대시보드에서 HTML 또는 ZIP으로 교체할 수 있습니다.
8. API 활용
개발자라면 API를 통해 프로그래밍 방식으로 URL을 단축할 수 있습니다. 자세한 내용은 API 문서를 참고하세요.