BOARD 문제 해결

웹 호스팅 환경에서 SSH를 활용한 심볼릭 링크 생성 방법

페이지 정보

작성자 최고관리자
댓글 0건 조회 0회 작성일 26-11-05 15:50

본문

그누보드 운영 중 SFTP 클라이언트의 한계로 디렉토리 구조 설정에 어려움을 겪는 운영자·개발자를 위해, SSH 터미널을 통한 심볼릭 링크 생성 방법과 확인 절차를 안내합니다.

웹 호스팅 환경에서 심볼릭 링크 생성 시 응답 없음 현상과 해결 방법

SFTP 클라이언트 사용 시 응답이 없는 이유

Cyberduck 등의 SFTP 클라이언트를 사용하여 www 디렉토리 선택 후 파일 > 새 심볼릭 링크... 메뉴에서 입력창에 g7/public/을 입력하고 생성 버튼을 눌러도 응답이 없는 현상은 주로 호스팅 환경의 보안 정책과 관련이 있습니다. SFTP 클라이언트는 파일 전송을 위한 도구이며, SFTP 접속이 가능하다고 해서 서버의 대화형 셸(interactive shell) 접속이 허용된 것은 아닙니다. 호스팅 업체에 따라 SFTP 파일 전송만 허용하고 대화형 셸 접속을 막아두는 경우가 있습니다.

또한, SFTP 클라이언트 환경에서는 절대경로 기준으로 입력하는 것이 일반적이지만, 웹 호스팅 환경에서는 보안 문제로 인해 정확한 절대경로를 식별하기 어려운 경우가 많아 심볼릭 링크 생성이 정상적으로 처리되지 않습니다.

SSH 터미널을 이용한 심볼릭 링크 생성 방법

호스팅 환경에서는 SFTP 클라이언트 대신 SSH 터미널을 통해 직접 서버에 접속하여 설정하는 것이 권장됩니다. 다만, SFTP가 된다고 하여 항상 SSH 셸 접속이 되는 것은 아니므로 사용 중인 호스팅 업체의 보안 설정 수준 및 SSH 접속 가능 여부를 먼저 확인해야 합니다.

SSH 터미널에 접속한 후에는 다음 명령어를 순서대로 실행하여 심볼릭 링크를 설정하고 결과를 확인할 수 있습니다.

기존 www 상태 확인
```
ls -la www
```
기존 www 삭제 후 재생성 (잘못 생성된 링크 삭제 등)
```
rm www
ln -s g7/public www
```

결과 확인 (아래와 같은 형태여야 함)

ls -la www
# lrwxrwxrwx 1 user user 9... www -> g7/public/

웹 호스팅 환경에서의 심볼릭 링크 생성 및 확인 절차

웹 호스팅 환경에서 SFTP 클라이언트(예: Cyberduck)를 통해 심볼릭 링크를 생성하려고 할 때 응답이 없거나 절대경로 식별이 어려운 보안 문제가 발생할 수 있습니다. 따라서 호스팅 환경에서는 SFTP 클라이언트 대신 SSH 터미널을 통한 직접 설정을 권장합니다.

1. 사전 확인 사항

호스팅 업체가 대화형 셸(interactive shell) 접속을 허용하는지 확인해야 합니다. (SFTP 파일 전송이 가능하다고 해서 SSH 셸 접속이 항상 가능한 것은 아니며, 호스팅 업체에 따라 접속을 막아둘 수 있습니다.)

2. 심볼릭 링크 생성 및 확인 절차

SSH 터미널 접속 후 아래 명령어를 순서대로 실행합니다. 기존 www 디렉토리가 있다면 삭제 후 재생성해야 하므로, 작업 전 반드시 백업을 권장합니다.

# 1. 기존 상태 확인
ls -la www

# 2. 기존 디렉토리 삭제 및 심볼릭 링크 생성
rm www
ln -s g7/public www

# 3. 결과 확인
ls -la www

정상 설정 시 lrwxrwxrwx... www -> g7/public/ 형태가 출력됩니다.

웹 호스팅 환경에서 심볼릭 링크 생성 방법

SFTP 클라이언트 사용 시 한계와 원인

Cyberduck 등의 SFTP 클라이언트를 통해 서버에 접속하여 디렉토리 설정 중 www 디렉토리 선택 후 파일 / 새 심볼릭 링크... 메뉴의 입력창에 g7/public/을 입력하고 생성 버튼을 눌러도 응답이 없는 현상이 발생할 수 있습니다.

이는 SFTP 클라이언트가 SSH 터미널과 다르기 때문이며, 호스팅 환경에서는 보안 문제로 인해 정확한 절대경로를 식별하기 어려운 경우가 주된 원인입니다. 또한 SFTP 접속이 가능하다 해서 대화형 셸(interactive shell) 접속이 항상 허용되는 것은 아니며, 호스팅 업체가 파일 전송만 허용하고 대화형 셸을 막아둔 경우도 있습니다.

SSH 터미널을 통한 설정 방법

호스팅 환경에서는 SFTP 클라이언트 대신 SSH 터미널로 직접 접속하여 설정을 진행하는 것이 권장됩니다.

SSH 터미널로 서버에 접속합니다.
기존 www 상태를 확인합니다.
```
ls -la www
```
기존 www를 삭제 후 재생성합니다.
```
rm www
ln -s g7/public www
```
결과를 확인합니다. 아래와 같은 형태여야 정상입니다.
```
ls -la www
# lrwxrwxrwx 1 user user 9... www -> g7/public/
```

SSH 셸 접속이 차단된 경우의 대안

국내 웹호스팅 업체의 경우 보안을 이유로 SSH 접속 권한을 비활성화해 두거나 FTP 접속 권한만 부여하고 SSH 접속 권한은 아예 부여하지 않는 경우가 많습니다.

호스팅 제어판 확인: 제어판이나 관리 페이지(예: 카페24 등)의 FTP/Shell 접속 설정 메뉴에서 Shell(SSH) 접속 설정이 차단으로 되어 있다면 이를 허용으로 변경한 후 적용해야 합니다.
고객센터 문의: 호스팅 업체가 애초에 SSH 접속을 지원하지 않거나 키 생성 작업 등이 필요한 경우에는 호스팅 업체의 1:1 문의를 통해 심볼릭 링크 생성 대안이나 SSH 접속 권한 부여를 요청해야 합니다.

주의 사항

사용 중인 호스팅 업체의 정책 및 보안 설정 수준에 따라 대화형 셸 접속 여부나 절대경로 인식 방식이 다를 수 있습니다.

웹 호스팅 환경 심볼릭 링크 설정 가이드

내 상황

문제: Cyberduck 등 SFTP 클라이언트에서 심볼릭 링크 생성 시 응답 없음
원인: SFTP는 파일 전송 전용이며, 호스팅 환경의 보안 정책상 대화형 셸(Shell) 접속이 차단되어 있거나 절대경로 식별이 어려움

선택 기준

SSH 접속 가능 여부: 호스팅 업체 제어판에서 SSH(Shell) 접속 설정이 '허용' 상태인지 확인
접근 방식: SFTP 클라이언트의 기능 대신 SSH 터미널을 통한 직접 명령어 실행 권장

다음 행동

접속 설정: 호스팅 관리 페이지에서 SSH 접속 권한을 '허용'으로 변경
터미널 접속: SSH 클라이언트(PuTTY 등)로 서버 접속
링크 생성 및 검증: 아래 명령어를 순서대로 실행
```
ls -la www
rm www
ln -s g7/public www
ls -la www
```

실전 FAQ

Q. SSH 설정을 허용했는데도 접속이 안 됩니다.

원인: 보안상 1개월 이상 미접속 시 자동 차단되거나, 특정 포트(예: 1661) 사용이 필요할 수 있음.
대안: 제어판에서 [차단] 후 다시 [허용]으로 적용하거나, 업체 1:1 문의를 통해 SSH 키 생성 및 권한 부여 여부를 확인하십시오.

Q. `rm www` 명령어 사용 시 주의사항은?

주의: www가 실제 디렉토리인지 링크인지에 따라 삭제 시 데이터 손실 위험이 있음.
대안: 삭제 전 반드시 ls -la www로 상태를 확인하고, 잘못 생성된 링크인 경우에만 삭제하십시오.

참고자료

기타 참고자료

이전글그누보드7 설치 시 .env 파일 누락 오류 해결 및 환경 설정 방법 26.11.05
다음글NHN KCP 휴대폰 본인인증 V2 패치 적용 및 설정 가이드 26.11.04

댓글목록

등록된 댓글이 없습니다.