게시 연동
FTP, SFTP, 정적 사이트
최종 업데이트:
FTP, SFTP 또는 정적 사이트로 연결해요. 입력 항목, 업로드되는 파일, 그리고 게시 취소가 어떻게 동작하는지 안내해요.
사이트가 CMS 없이 운영된다면(정적 사이트이거나 콘텐츠 API가 없는 호스팅이라면) Clodix가 FTP 또는 SFTP를 통해 게시된 아티클을 각각 별도의 HTML 페이지로 웹 호스트에 바로 업로드할 수 있어요.
연결하기
- Settings → Publishing integrations를 열고 FTP / SFTP / Static site를 클릭하세요.
- 호스팅 업체에서 연결 정보를 받으세요(Hostinger, GoDaddy, Bluehost, OVH 등 대부분의 호스트는 "FTP accounts" 또는 비슷한 메뉴에서 보여 줘요).
| 입력란 | 입력할 내용 |
|---|---|
| FTP Host | 호스트의 FTP 주소예요. 예: ftp.yoursite.com. |
| Username | FTP 계정 사용자 이름이에요. |
| Password | FTP 계정 비밀번호예요. |
| Port | FTP는 21, SFTP는 22예요(아래 참고). 비워 두면 기본값(21)이 사용돼요. 다른 포트는 지원하지 않아요. |
| Blog folder path | 아티클 페이지가 들어갈 서버의 폴더예요. 예: /public_html/blog/. |
| Website URL (선택) | 해당 폴더의 공개 주소예요. 예: https://yoursite.com/blog. 각 아티클의 링크와 SEO 태그를 만드는 데 사용돼요(아래 참고). |
- Connect를 클릭하세요. Clodix가 실시간으로 연결하고, 저장하기 전에 폴더에 접근할 수 있는지 확인해요.
업로드되는 파일
게시된 아티클은 각각 독립된 파일 하나, <slug>.html이 되어 블로그 폴더에 기록돼요. 예를 들어 best-pour-over.html처럼요. 페이지에는 다음이 포함돼요.
- 아티클의 제목과 본문, 그리고 간단한 기본 스타일(테마나 템플릿이 필요 없어요).
- 올바른
<title>과 메타 설명. - Open Graph 태그(소셜 미디어 링크 미리보기용)와 Twitter 카드 태그.
- 아티클의 canonical URL과 구조화 데이터(JSON-LD). 단, Website URL을 설정한 경우에만 포함돼요. 설정하지 않으면 Clodix가 선언할 실제 공개 주소를 알 수 없기 때문에, URL에 의존하는 이 태그들은 추측하지 않고 생략해요.
Clodix는 색인 페이지나 목록 페이지를 만들지 않아요. 개별 아티클 페이지만 만들어요. 아티클을 나열하는 페이지가 필요하다면 각 아티클에 직접 링크하거나 RSS 피드를 이용해 만들어야 해요.
업데이트와 게시 취소
- 나중에 아티클을 수정하고 다시 게시하면 같은 파일을 덮어써요.
<slug>.html이 최신 콘텐츠로 다시 생성되므로 사본이 두 개가 되는 일은 없어요. - 게시 취소(Unpublish)를 하면 서버에서 파일이 삭제돼요. WordPress, Ghost, Shopify, HubSpot과 달리 일반 파일 호스트에는 "초안" 상태가 없어요. 아티클의 원본은 Clodix에 안전하게 남아 있고, 다시 게시하면 똑같은 페이지가 복원돼요.
자주 발생하는 문제
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| "Couldn't connect to the FTP server — check the host and the port" | Clodix가 연결을 열 수 없었어요. 호스트가 잘못되었거나 오프라인이거나, 포트가 21 또는 22가 아니거나, 호스트가 로컬 또는 사설 네트워크를 가리키고 있어요. | 호스팅 업체가 보여 주는 공개 FTP 주소와 포트 21(FTP) 또는 22(SFTP)를 사용하세요. |
| "The FTP server refused: …" | 서버가 응답했지만 거부했어요. 대부분 사용자 이름이나 비밀번호가 틀렸거나, 폴더가 없고 만들 수도 없는 경우예요. | 호스팅 업체가 보여 주는 로그인 정보와 다시 대조하고, 계정이 해당 폴더에 쓰기 권한이 있는지 확인하세요. |
FAQ
Website URL을 꼭 설정해야 하나요?
선택 사항이지만, 설정하지 않으면 Clodix가 페이지에 올바른 canonical 링크, Open Graph 태그, 구조화 데이터를 만들 수 없어요. 모두 SEO와 공유될 때 페이지가 보이는 모습에 중요한 요소예요. 블로그 폴더가 실제로 제공되는 주소로 설정하세요.
호스트가 SFTP 없이 FTP만 지원하면 어떻게 하나요?
일반 FTP(포트 21)도 여전히 사용할 수 있어요. Clodix는 먼저 일반 연결을 시도하고, 호스트가 요구하면 FTPS(암호화)로 자동 전환해요.
CMS 연동과 함께 사용할 수 있나요?
아니요. 사이트에는 한 번에 하나의 게시 연동만 연결할 수 있어요. FTP와 CMS 사이를 전환하려면 Settings → Publishing integrations → Manage에서 현재 연동을 Disconnect한 다음 다른 연동을 연결하세요.