EQVPS

VPS에서 AI 에이전트 실행하는 방법 (Python, venv, systemd)

VPS에서 AI 에이전트를 실행하는 복사-붙여넣기 가이드: Python과 virtualenv를 설정하고, API 키를 env 파일에 보관하며, 에이전트를 systemd 서비스로 감싸 충돌 시 재시작하고 재부팅에도 살아남게 한다.

노트북이 열려 있을 때만 실행되는 AI 에이전트는 스크립트일 뿐입니다. 그것을 스스로 실행하도록 — 재연결하고, 재시도하고, 재부팅을 견디도록 — 만들려면 systemd 아래 VPS에 올리세요. 이것은 최소한의 복사-붙여넣기 가이드입니다. 이유와 더 긴 형태(가동 시간, 크기 산정, MCP 관점)는 AI 에이전트 24/7 실행AI 에이전트용 VPS 개요를 보세요.

1. Python과 virtualenv

apt update && apt install -y python3-venv python3-pip git
git clone https://github.com/you/your-agent.git /opt/agent
cd /opt/agent
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

2. API 키를 env 파일에 보관하기

키를 절대 코드에 하드코딩하지 마세요. root만 읽을 수 있는 파일에 넣으세요:

cat >/opt/agent/.env <<'EOF'
ANTHROPIC_API_KEY=sk-ant-...
EOF
chmod 600 /opt/agent/.env

3. systemd 서비스로 감싸기

# /etc/systemd/system/agent.service
[Unit]
Description=AI Agent
After=network.target

[Service]
WorkingDirectory=/opt/agent
ExecStart=/opt/agent/.venv/bin/python main.py
EnvironmentFile=/opt/agent/.env
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now agent
journalctl -u agent -f      # watch it run

Restart=always가 핵심 전부입니다: 새벽 3시의 충돌은 에이전트를 아침까지 죽은 채 두는 대신 재시작합니다. (이 패턴에 대한 자세한 내용은 systemd 서비스 만들기에서.)

4. 충돌 루프에 주의하기

에이전트가 시작하자마자 즉시 실패하면 Restart=always는 영원히 재시도합니다. RestartSec=5가 시도 간격을 벌립니다. 근본 원인(대개 누락된 env 변수나 의존성)을 고치려면 journalctl -u agent를 읽으세요.

크기 산정과 솔직한 부분

EQVPS는 MCP 서버도 제공하므로, 에이전트가 자기 머신을 스스로 프로비저닝할 수도 있습니다. 약 1분이면 root, KYC 없음, 암호화폐로 결제.

자주 묻는 질문

VPS에서 AI 에이전트를 실행하려면 무엇이 필요한가요?

에이전트 의존성을 위한 virtualenv가 있는 Python, 환경 파일에 넣은 모델 API 키, 그리고 충돌 시 재시작하고 부팅 시 시작하도록 하는 systemd 서비스입니다. 에이전트가 호스팅된 모델을 호출한다면(흔한 경우) 그게 전부입니다 — GPU 없음. 단계는 아래에 있으며, root는 약 1분이면 얻습니다.

API 키는 어디에 두나요?

EnvironmentFile에(chmod 600), 절대 unit 파일이나 git에 커밋하지 마세요. systemd가 시작 시 프로세스 환경으로 로드합니다. 그러면 유출된 unit이나 저장소가 키를 노출하지 않습니다.

연결을 끊은 뒤에도 에이전트를 계속 실행하려면?

Restart=always를 붙인 systemd 서비스로 감싸세요. 터미널이나 nohup으로 실행하는 것과 달리 systemd는 충돌 시 재시작하고, 부팅 시 시작하며, 로그를 journalctl로 수집합니다. 그것이 스크립트와 스스로를 실행하는 에이전트의 차이입니다.

GPU가 필요한가요?

에이전트가 API로 호스팅된 모델을 호출한다면 필요 없습니다 — CPU 전용 오케스트레이션 작업이라 작은 머신에서도 편안합니다. GPU는 모델을 로컬에서 실행할 때만 필요한데, 그건 제공하지 않습니다. CPU에서 작은 로컬 모델을 돌리려면 Ollama 가이드를 보세요.

신분증이나 카드를 요구하나요?

아니요. 가입에 이메일, 결제는 USDC 또는 USDT — 서류 없음, 카드 없음. 약 1분이면 root.

댓글

아직 댓글이 없습니다. 첫 번째가 되세요.

댓글 남기기

댓글은 표시되기 전에 검토됩니다.