운영·보안

AI에게 SSH 서버 작업을 맡길 때 제가 꼭 확인하는 7가지

목차 보기

AI 코딩 도구로 웹사이트를 만들기 시작했을 때는 주로 로컬 파일을 고쳤습니다. 화면을 바꾸고 글을 추가한 뒤 문제가 생겨도 원본을 다시 열거나 이전 코드와 비교하면 됐습니다. 하지만 완성된 사이트를 운영하려면 결국 서버에 결과물을 올려야 했습니다.

현재 minml은 Astro로 만든 정적 사이트를 기존 서버에 직접 배포합니다. 저는 명령어를 모두 외워 입력하기보다 Codex 같은 AI 도구에 작업 목적을 설명하고, 로컬 확인부터 SSH 접속과 배포 후 점검까지 도움받고 있습니다. 편리하지만 운영 서버는 연습용 폴더와 다릅니다. 한 번 잘못 지운 파일은 방문자가 보는 사이트를 바로 망가뜨릴 수 있습니다.

그래서 “서버에 접속해서 알아서 처리해줘”라고만 요청하지 않습니다. AI가 어떤 모델인지보다 어디까지 읽어도 되는지, 무엇을 바꿔도 되는지, 결과를 어떻게 확인할지를 먼저 정합니다.

1. 대상 서버 확인

가장 먼저 확인하는 것은 파일이 아니라 서버의 정체입니다. SSH 별칭이 비슷하거나 여러 서버를 관리한다면 엉뚱한 장비에 접속한 상태에서도 명령 자체는 정상적으로 실행될 수 있습니다.

이 글을 준비하면서도 처음에는 SSH 별칭으로 접속이 가능한지만 확인했습니다. 파일을 바꾸지 않고 호스트 이름과 웹 서버 상태를 읽었습니다. 아래 명령과 출력에서는 실제 접속 정보와 서비스 이름을 플레이스홀더로 바꿨습니다.

ssh <서버별칭> "hostname; systemctl is-active <웹서버>"
<호스트 이름>
active

이 두 줄이 알려주는 것은 접속한 장비와 웹 서버의 현재 상태뿐입니다. 그래도 작업 전 기준으로 기록해 두면 이후 문제가 생겼을 때 원래부터 중지돼 있었는지, 작업 뒤에 멈췄는지를 구분하기 쉽습니다.

접속 계정의 권한도 확인합니다. 권한이 클수록 편하지만 잘못된 명령이 영향을 줄 범위도 넓습니다.

2. 읽기 전용 조사

서버 구조를 모르는 상태에서 수정과 조사를 한 번에 시키지 않습니다. 먼저 디렉터리 목록, 링크 대상, 실행 중인 서비스와 공개 주소의 응답만 확인하게 합니다. 제가 자주 요청하는 범위는 다음과 같습니다.

  • 대상 사이트의 배포 디렉터리가 어디인지
  • 현재 공개 중인 릴리스가 무엇인지
  • Nginx가 어떤 디렉터리를 바라보는지
  • 홈페이지와 주요 글이 어떤 HTTP 상태로 응답하는지
  • 함께 운영되는 다른 서비스가 있는지

이번 조사에서 minml 서버에는 releases/ 디렉터리와 current 링크가 있었고, current는 기존 릴리스 하나를 가리키고 있었습니다. 서버에는 minml과 관련 없는 사이트도 함께 있었습니다. 이 사실을 먼저 알았기 때문에 이후 작업 범위를 minml 배포 디렉터리로 한정할 수 있었습니다.

읽기 전용 조사를 별도 단계로 두면 AI가 제시한 다음 작업도 검토하기 쉬워집니다. 실제 구조를 보기도 전에 예상 경로를 만들어내거나, 사용하지 않는 배포 방식을 전제로 설명하는 일을 줄일 수 있습니다.

3. 수정 대상과 제외 대상

“minml을 배포해줘”라는 문장에는 사이트 코드, Nginx 설정, 인증서, 서버의 다른 디렉터리 중 어디까지 건드려도 되는지가 없습니다. 그래서 서버 작업을 요청할 때는 세 범위를 나눠 적습니다.

구분 범위
수정 대상 로컬 minml 프로젝트, 새 글과 대표 이미지, minml의 새 릴리스 디렉터리
확인 대상 현재 릴리스 링크, Nginx 상태, minml 공개 주소와 사이트맵
제외 대상 minml 배포 디렉터리 밖의 경로, 데이터베이스, 인증서와 방화벽 설정

서버에서는 제외 대상이 특히 중요합니다. 새 글 배포에 데이터베이스나 인증서 변경은 필요하지 않으므로 처음부터 제외하고, “필요하면 다른 것도 정리” 같은 표현은 쓰지 않습니다. 목표·범위·완료 조건을 나누는 일반적인 요청 구조는 AI에게 어디까지 맡길지 나눈 역할과 검증 기준에 정리했습니다.

4. 복구 지점

SSH 작업을 시작하기 전에는 로컬 소스가 빌드 가능한지, 현재 공개 중인 릴리스가 무엇인지, 실패하면 어느 릴리스로 돌아갈지를 먼저 확인합니다. 소스 백업과 복구는 Astro 블로그 백업과 복구 방법에, 과거 릴리스를 몇 개 남기고 언제 지우는지는 새 릴리스 교체 배포에 정리했습니다.

5. 승인과 명령 검토

이 글을 준비하며 SSH 접속을 시험할 때, 로컬 작업 환경의 제한 때문에 처음에는 SSH 별칭(<서버별칭>)을 읽지 못했습니다. 이후 네트워크가 필요한 읽기 전용 접속 명령과 목적을 확인한 뒤 승인했고, 그제야 실제 서버에 접속했습니다. 제한을 몰래 우회한 것이 아니라 경계 밖 작업을 따로 드러낸 셈입니다.

OpenAI 공식 문서는 Codex의 샌드박스를 에이전트가 기본적으로 접근할 수 있는 파일과 네트워크 범위를 정하는 경계로 설명합니다. 그 경계를 넘어야 할 때는 승인 흐름이 작동합니다. 하지만 제가 승인 버튼을 누른 사실이 원격 명령의 내용까지 검토했다는 뜻은 아닙니다. 권한과 결정을 나누는 원칙은 역할과 검증 기준에서 다뤘고, SSH 승인 요청을 볼 때는 다음을 구체적으로 확인합니다.

  • 왜 서버 접속이 필요한가
  • 읽기만 하는가, 파일을 바꾸는가
  • 명령에 대상 경로가 정확히 적혀 있는가
  • 재귀 삭제나 넓은 와일드카드가 포함돼 있는가
  • 실패했을 때 기존 사이트가 그대로 남는가

특히 삭제 명령은 축약된 경로나 아직 값이 정해지지 않은 변수에 기대지 않습니다. 서버 루트나 웹사이트 전체 디렉터리를 넓게 대상으로 삼지 않고, 먼저 실제 절대 경로를 출력해 확인합니다. 제가 요청한 목적과 명령이 일치할 때만 승인합니다.

6. 새 릴리스 배포

minml은 공개 폴더에 파일을 덮어쓰지 않고, 새 릴리스 디렉터리에 완성본을 올려 검사한 뒤 current 링크를 바꿉니다. AI에게는 이 순서를 바꾸지 말고 실패하면 직전 릴리스로 돌아가라고 요청하며, 전체 순서와 교체 방법은 새 릴리스 교체 배포에 있습니다.

7. 배포 후 응답 확인

홈페이지 200만 보고 끝내지 않고 새 글·이미지·사이트맵, 없는 주소의 404, 통합 주소의 301을 따로 확인하게 합니다. 이 글을 쓰기 전에도 작업 전 기준으로 홈페이지 200, 시험 주소 404, 통합 주소 301과 Nginx active를 먼저 읽어 두었습니다. 항목별 이유는 새 릴리스 교체 배포의 공개 후 응답 검사에 정리했습니다.

실제 요청문

긴 보안 지침을 매번 새로 쓸 필요는 없지만, 목적과 경계는 짧게라도 명시합니다. 아래와 같은 형태로 요청하면 조사와 변경이 섞이는 것을 줄일 수 있었습니다.

먼저 SSH로 대상 서버와 현재 배포 상태를 읽기 전용으로 확인해줘.
결과를 보고한 뒤 새 릴리스를 준비하고, 변경이 필요한 명령은 실행 전에 알려줘.

수정 대상: minml의 새 릴리스와 current 링크
확인 대상: Nginx 상태, 새 글, 대표 이미지, 사이트맵, 301과 404
건드리지 않을 대상: minml 배포 디렉터리 밖의 경로, 데이터베이스, 인증서, 방화벽
실패 시: 기존 current 대상을 유지하거나 직전 릴리스로 복구

반복해서 적용할 규칙은 AGENTS.md 같은 파일에 적어둘 수도 있습니다. 그래도 매번 결과 확인은 생략하지 않습니다. 실제 서버 상태는 지난 작업 이후 달라질 수 있기 때문입니다.

참고한 공식 문서