문서

빠른 시작 + 부분별, 기기별 기능 설명 (계속 업데이트 중)

자주 묻는 질문 FAQ

이 문서는 패널을 사용하면서 가장 자주 마주치는 문제와 점검 방법을 정리했습니다.

설치와 로그인

Q: 패널 설치에는 어떤 조건이 필요한가요?

공인 IP가 있는 Linux 서버 한 대(주요 배포판인 Debian / Ubuntu / CentOS 등 권장)면 되고, 메모리 512MB 이상이면 부드럽게 돌아갑니다. 관리 대상 서버에는 아무것도 설치할 필요가 없고 SSH로 접속할 수 있기만 하면 됩니다.

Q: 기본 계정과 비밀번호는 무엇인가요?

기본 계정 admin, 비밀번호 123456. 최초 로그인 후 즉시 변경하세요 (패널 오른쪽 위 사용자 아이콘 → 사용자 설정).

Q: 로그인 비밀번호를 잊어버렸습니다. 어떻게 하나요?

변경한 뒤 잊어버렸다면 패널 서버에서 재설정할 수 있습니다. 다음 명령으로 기본 비밀번호로 재설정하거나 새 비밀번호를 지정하세요:

# 패널 설치 디렉터리로 이동해 내장 스크립트로 비밀번호 재설정
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('새비밀번호')"

> 정확한 스크립트 이름은 버전에 따라 다를 수 있으며, data/ssheverywhere.db 데이터베이스의 users 테이블을 직접 편집해도 됩니다.

Q: 패널 포트(5501)는 어떻게 변경하나요?

systemd 서비스의 Environment=PORT=5501을 수정한 뒤 다시 로드합니다:

systemctl edit ssh-everywhere.service
# 추가 또는 수정: Environment=PORT=<사용할-포트>
systemctl daemon-reload && systemctl restart ssh-everywhere.service

변경한 뒤에는 클라우드 방화벽/보안 그룹에서 새 포트를 허용하는 것을 잊지 마세요.

Q: 패널에 접속할 수 없습니다(5501 포트)?

순서대로 점검하세요:

1. 패널 서비스가 실행 중인지 확인: systemctl status ssh-everywhere.service

2. 패널 서버의 클라우드 방화벽/보안 그룹에서 5501을 허용했는지 확인 (가장 흔한 원인)

3. 접속 주소가 http://서버공인IP:5501이 맞는지 확인 (리버스 프록시를 구성하지 않았다면 https가 아님)

서버 관련

Q: 서버가 「오프라인」으로 표시되면 어떻게 하나요?

「오프라인」은 패널이 SSH로 접속할 수 없다는 뜻일 뿐이며, 서버 다운을 의미하지 않습니다. 순서대로 점검하세요:

1. 서버 자체가 온라인인지 확인: 서비스 제공자 콘솔에서 전원 상태 확인

2. SSH 포트 도달성 테스트: 패널 서버에서 nc -zv <대상IP> <포트>로 포트가 열려 있는지 확인

3. 방화벽/보안 그룹 확인: 대상 서버의 클라우드 방화벽/보안 그룹이 SSH 포트를 허용했는지

4. NAT 서버는 포트 매핑 확인: NAT 포트 매핑이 아직 있고 대상 내부 IP가 맞는지 확인

5. 출발지 IP 화이트리스트 확인: 일부 서비스 제공자는 SSH 포트에 출발지 IP 제한을 걸어 두므로 패널 서버 IP를 화이트리스트에 추가해야 함

6. 계정과 비밀번호 대조: 사용자 이름, 비밀번호/개인 키가 올바른지

Q: 서버를 추가할 때 연결되지 않습니다?

  • SSH 포트, 사용자 이름, 비밀번호가 올바른지 확인
  • 대상 서버의 sshd가 실행 중인지 확인
  • 방화벽이 SSH 포트를 허용했는지 확인
  • 대형 클라우드(Tencent Cloud/Alibaba Cloud)는 기본적으로 root를 막아 두므로 일반 사용자(예: ubuntu)로 로그인하세요

Q: NAT 서버(22 이외 포트)에 연결되지 않습니다?

NAT 서버의 포트 매핑은 패널 서버가 있는 네트워크에서 접근할 수 있어야 합니다. 흔한 원인:

  • 포트 매핑이 무효화됨 (서비스 제공자 콘솔에서 확인/재생성)
  • 서비스 제공자가 출발지 IP를 화이트리스트로 제한 (패널 서버 IP 추가)
  • 매핑한 대상 내부 IP/포트를 잘못 입력

포트 터널링 / 포워딩 관련

Q: 포트 터널링이 「오프라인」으로 표시됩니다?

  • 터널링은 Agent가 온라인일 때 동작합니다. Agent가 오프라인이면(기기 전원 꺼짐, 네트워크 단절, Agent 중지) 터널링이 끊깁니다
  • 패널 서비스를 재시작하면 Agent가 다시 연결될 때 터널링이 자동 복구되니 잠시 기다리면 됩니다
  • 패널 서버의 클라우드 방화벽이 리스닝 포트를 허용했는지 확인

Q: 22 이외 포트 포워딩이 동작하지 않습니다?

SSH가 아닌 포트(예: 9117)를 포워딩하려면 터널링 서버에 새 버전 Agent가 설치되어 있어야 합니다(구버전은 22만 지원). Agent를 다시 설치하면 됩니다.

Q: 포트 포워딩을 만들었는데 동작하지 않습니다?

전통적인 포트 포워딩은 독립 공인 IP가 있는 서버 본체에서 수행해야 합니다. 확인하세요:

1. 대상 서버/중간 방화벽이 대상 포트를 허용했는지

2. 대상 IP에 실제로 도달 가능한 주소를 넣었는지

3. 클라우드 보안 그룹이 리스닝 포트를 차단하지 않았는지

Q: 포트 터널링과 포트 포워딩의 차이는 무엇인가요?

  • 포트 터널링: 공인 IP가 없는 기기용. 리버스 터널을 거쳐 패널 서버에서 공인 포트를 엽니다.
  • 포트 포워딩: 공인 IP가 있는 서버용. 시스템 방화벽 DNAT를 거쳐 대상 서버 본체에서 수행합니다.

자세한 내용은 포트 터널링과 포트 포워딩을 참고하세요.

Docker / 앱 설치 관련

Q: 앱 모음/Docker 설치가 실패하면 어떻게 하나요?

패널은 오류 메시지를 있는 그대로 표시합니다(성공으로 거짓 보고하지 않습니다). 흔한 원인:

1. 너무 오래된 배포판: Fedora 32 등 이미 EOL된 버전은 소프트웨어 저장소가 유지보수를 중단해 설치가 타임아웃되거나 실패합니다. 시스템 업그레이드를 권장합니다.

2. 네트워크 도달 불가: Docker 공식 소스(get.docker.com / download.docker.com)는 일부 네트워크 환경(예: 중국 본토의 NAT 서버)에서 접속할 수 없을 수 있습니다. 이때는 Docker 국내 미러를 설정하거나 「미러」 기능으로 Alibaba Cloud 소스로 전환하세요.

3. 패키지 이름 차이: 일부 앱(예: ufw, Node.js의 deb.nodesource)은 특정 배포판에 의존해 Debian/Ubuntu가 아닌 환경에서는 설치되지 않을 수 있으며, 오류 메시지가 이를 명확히 알려 줍니다.

Q: 중국 본토 서버에서 Docker 이미지 받기가 매우 느리거나 타임아웃됩니까?

이것은 네트워크 문제이지 패널 문제가 아닙니다. Docker 이미지 가속기(공용 가속기 예: docker.1ms.run / docker.m.daocloud.io)를 설정하거나, 서버에서 먼저 다음을 실행하세요:

# 참고: Alibaba Cloud 개인 가속기 구성 (자신의 가속기 주소로 교체)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://<가속기-주소>"] }
EOF
sudo systemctl restart docker

일반적인 문제 해결 팁

1. 포트가 열려 있는지 먼저 테스트한 뒤 계정과 비밀번호를 점검: nc -zv <IP> <포트>

2. 다른 서버와 비교: 같은 유형의 서버는 연결되는데 이 서버만 안 된다면 이 서버 특유의 문제(방화벽/매핑/화이트리스트)

3. 로그 확인: 패널 로그는 service.log에 있고, 터널링/Agent 로그가 연결 문제를 파악하는 데 도움이 됩니다