cursor ai에서 내 사이트의 ftp를 연결해서 코드를 수정하고 싶다.어떤 절차가 필요할까요?

Cursor AI (Visual Studio Code 기반)에서 FTP/SFTP를 연결하여 웹사이트 코드를 수정하려면 다음과 같은 절차가 필요합니다. Cursor AI 자체에는 FTP/SFTP 기능이 내장되어 있지 않으므로, VS Code 확장 프로그램을 설치하고 설정해야 합니다.

 

1. SFTP/FTP 확장 프로그램 설치

• Cursor AI의 왼쪽 사이드바에서 확장(Extensions) 아이콘 (네모 블록 모양)을 클릭합니다.
• 검색창에 SFTP 또는 FTP 를 입력합니다.
• 가장 인기 있고 평가가 좋은 확장 프로그램을 선택하여 설치합니다. 일반적으로 liximomo의 "SFTP" 확장 프로그램이 많이 사용됩니다. (다른 FTP 관련 확장 프로그램도 사용할 수 있습니다.)
• "Install" 버튼을 클릭하여 설치합니다.

2. SFTP/FTP 연결 설정 구성

• 설치된 SFTP 확장 프로그램의 사용법에 따라 설정을 구성합니다. liximomo의 "SFTP" 확장 프로그램을 기준으로 설명하겠습니다.
• **명령 팔레트(Command Palette)**를 엽니다. (단축키: Ctrl+Shift+P 또는 Cmd+Shift+P)
• 명령 팔레트에 SFTP: Config 를 입력하고 실행합니다.
• 그러면 현재 작업 영역(프로젝트 폴더) 내에 .vscode 폴더가 생성되고 그 안에 sftp.json 파일이 열립니다. 이 파일에 FTP/SFTP 연결 정보를 입력합니다.

3. sftp.json 파일 작성 예시

JSON

 

{
    "name": "내 웹사이트 FTP",  // 이 연결의 별칭 (원하는 대로 지정)
    "host": "your_domain.com", // FTP 서버 주소 (예: ftp.example.com 또는 IP 주소)
    "protocol": "sftp",       // 접속 프로토콜 ('ftp' 또는 'sftp') - SFTP를 권장합니다.
    "port": 22,               // 접속 포트 (FTP 기본값: 21, SFTP 기본값: 22) - 호스팅 업체 정보 확인
    "username": "your_ftp_username", // FTP 사용자 이름
    // "password": "your_ftp_password", // 비밀번호 (보안상 아래 askForPassword 사용 권장)
    "askForPassword": true,   // 접속 시 비밀번호를 묻도록 설정 (보안 강화)
    "remotePath": "/public_html/", // 서버에 접속했을 때 기본으로 열릴 원격 경로 (예: /var/www/html, /httpdocs 등 - 호스팅 업체 확인 필요)
    "uploadOnSave": true,     // 파일을 저장할 때 자동으로 서버에 업로드할지 여부
    "useTempFile": false,     // 임시 파일을 사용할지 여부
    "openSsh": false          // OpenSSH 설정을 사용할지 여부 (SFTP 키 파일 사용 시 관련 설정 필요)
    // "privateKeyPath": "~/.ssh/id_rsa" // SFTP 접속 시 비밀번호 대신 키 파일을 사용할 경우 키 파일 경로 지정
}

• name: 연결 설정을 구분하기 위한 이름입니다.
• host: 웹 호스팅 업체에서 제공한 FTP/SFTP 서버 주소를 입력합니다.
• protocol: ftp 또는 sftp 중 사용하는 프로토콜을 지정합니다. 보안을 위해 가능하면 sftp 사용을 강력히 권장합니다.
• port: 호스팅 업체에서 지정한 포트 번호를 입력합니다. (FTP: 21, SFTP: 22가 기본이지만 다를 수 있습니다.)
• username: FTP/SFTP 계정 사용자 이름을 입력합니다.
• password: 비밀번호를 직접 입력할 수도 있지만, 보안상 sftp.json 파일에 저장하는 것은 좋지 않습니다. 대신 askForPassword: true 로 설정하면 접속할 때마다 비밀번호를 물어봅니다. (SFTP의 경우 비밀번호 대신 SSH 키 파일을 사용하는 것이 더 안전합니다.)
• remotePath: 웹사이트 파일이 있는 서버 상의 경로를 정확히 입력해야 합니다. (예: /home/user/public_html, /var/www/vhosts/domain.com/httpdocs 등) 이는 호스팅 환경마다 다르므로 반드시 확인해야 합니다.
• uploadOnSave: true로 설정하면 Cursor AI에서 파일을 편집하고 저장할 때마다 자동으로 서버에 업로드되어 편리합니다.

 

4. 서버에 연결 및 파일 수정

• sftp.json 파일 작성이 완료되면 저장합니다.
• Cursor AI의 왼쪽 사이드바에 SFTP 아이콘이 나타날 수 있습니다 (확장 프로그램에 따라 다름). 또는 **명령 팔레트 (Ctrl+Shift+P 또는 Cmd+Shift+P)**를 열고 SFTP: List All 같은 명령어를 실행하여 설정된 연결 목록을 확인하고 접속할 수 있습니다.
• 설정한 이름("내 웹사이트 FTP")을 선택하여 연결합니다. (askForPassword: true로 설정했다면 비밀번호를 입력하라는 창이 뜰 것입니다.)
• 연결에 성공하면 Cursor AI의 탐색기(Explorer) 뷰에 원격 서버의 파일 및 폴더 목록이 나타납니다.
• 탐색기에서 수정하려는 파일을 클릭하면 해당 파일이 다운로드되어 편집기에 열립니다.
• 코드를 수정한 후 파일을 저장 (Ctrl+S 또는 Cmd+S) 합니다.
  • uploadOnSave: true 로 설정했다면 저장과 동시에 수정된 파일이 서버로 자동 업로드됩니다.
  • uploadOnSave: false 로 설정했다면, 파일을 마우스 오른쪽 버튼으로 클릭하여 나타나는 메뉴에서 "Upload" 또는 유사한 옵션을 선택하여 수동으로 업로드해야 합니다.

중요 참고 사항:

• 보안: FTP는 데이터 전송 시 암호화되지 않아 보안에 취약합니다. 가능하면 **SFTP (SSH File Transfer Protocol)**를 사용하세요. SFTP는 SSH를 기반으로 하므로 데이터 전송이 암호화됩니다. 호스팅 업체가 SFTP를 지원하는지 확인해 보세요.
• 백업: 서버의 파일을 직접 수정하기 전에 반드시 웹사이트 전체를 백업하세요. 실수로 파일을 잘못 수정하거나 삭제하면 웹사이트가 작동하지 않을 수 있습니다.
• 정확한 정보: host, port, username, password, remotePath 등의 정보는 웹 호스팅 서비스 업체에서 제공하는 정보를 정확하게 입력해야 합니다. 호스팅 제어판(cPanel, Plesk 등)이나 고객 지원을 통해 확인할 수 있습니다.
• 방화벽: 로컬 컴퓨터나 서버의 방화벽 설정 때문에 FTP/SFTP 연결이 차단될 수 있습니다. 연결에 문제가 있다면 방화벽 설정을 확인해 보세요.

이 절차를 따라 진행하시면 Cursor AI를 사용하여 FTP/SFTP로 서버에 접속하고 코드를 수정할 수 있습니다. 문제가 발생하면 사용 중인 SFTP 확장 프로그램의 문서나 커뮤니티를 참조하거나, 호스팅 업체에 문의해 보세요.