Turb GPT Register 튜토리얼: 로컬 등록 프로세스 및 WebUI 구축

프로젝트 소개

Turb GPT Register는 로컬에서 실행되는 등록 프로세스 도구로, gpt-free-register를 기반으로 정리하고 확장한 프로젝트입니다. 이메일, 프록시와 등록 프로세스를 통합 관리하며, 프로토콜 기반 방식과 로컬 지문 브라우저 연결을 모두 지원합니다.

프로젝트는 명령줄에서 시작할 수 있으며, 실행 환경 구성과 작업 관리를 위한 로컬 WebUI를 제공합니다. 단, 계정, 이메일 또는 프록시를 제공하지 않으며 타사 서비스의 지속적인 이용 가능성을 보장하지 않습니다.

사용 권한이 있는 환경에서만 실행하고 관련 서비스, 이메일 제공업체 및 프록시 제공업체의 규정을 준수하세요.

주요 기능 및 프로젝트 구조

주요 특징

• 로컬에서 실행되며 구성과 결과가 로컬에 저장됩니다.
• 이메일 서비스, 프록시 및 등록 프로세스를 통합 관리합니다.
• 프로토콜 기반 등록 구성 요소를 지원합니다.
• 로컬 지문 브라우저에 연결할 수 있습니다.
• 명령줄 진입점과 로컬 WebUI를 제공합니다.
• 핵심 로직, 구성, 페이지, 도구 및 타사 구성 요소를 디렉터리별로 관리합니다.

디렉터리 설명

• core/: 메인 프로그램 및 핵심 로직.
• config/: 프로젝트 구성.
• webui/: 로컬 관리 페이지.
• tools/: 보조 스크립트.
• vendor/gpt-register-tool/协议: 프로토콜 등록 구성 요소 및 관련 파일.

코드나 구성 문제를 조사할 때는 먼저 기능에 따라 해당 디렉터리를 찾는 것이 좋습니다. 일반적으로 전체 저장소에서 검색하는 것보다 효율적입니다.

설치 전 준비

프로젝트는 Python 3.11 사용을 권장합니다. 아래 설치 명령은 Windows PowerShell에 적용되며, 저장소를 이미 로컬에 다운로드했다고 가정합니다.

또한 사용할 수 있는 이메일 서비스와 프록시 구성은 직접 준비해야 합니다. 브라우저 드라이버를 사용하는 경우 추가 브라우저나 공급업체 클라이언트를 설치해야 할 수도 있습니다. pip install은 Python 종속성만 설치하며 이러한 외부 프로그램을 자동으로 설치하지 않습니다.

설치 및 시작

1단계: 가상 환경 생성

저장소 루트 디렉터리에서 PowerShell을 열고 .venv라는 이름의 Python 가상 환경을 생성합니다.

python -m venv .venv

2단계: 가상 환경 활성화

.venv\Scripts\Activate.ps1

활성화하면 이후 설치되는 Python 패키지가 해당 프로젝트의 가상 환경에 저장되어 시스템의 다른 Python 프로젝트에 영향을 주지 않습니다.

3단계: 종속성 설치

pip install -r requirements.txt

설치에 실패하면 전체 오류 내용을 기록하고 Python 버전, 네트워크 환경 및 종속성 설치 로그를 확인하세요.

4단계: 로컬 구성 파일 생성

Copy-Item .env.example .env

.env.example은 구성 예시 파일입니다. 복사가 완료되면 자신의 .env를 편집하여 실제 실행 환경에 필요한 구성을 입력하세요.

실제 이메일 자격 증명, 프록시 키 또는 기타 민감한 정보를 .env.example에 기록하지 말고, 실제 자격 증명이 포함된 .env를 Git에 커밋하지 마세요.

5단계: WebUI 시작

python web.py

프로그램이 시작되면 로컬 WebUI를 열고 페이지의 구성 항목에 자신의 이메일 서비스와 프록시 정보를 입력한 후 관련 작업을 관리하세요. README에는 고정된 페이지 주소나 필드 이름이 명시되어 있지 않으므로 프로그램 시작 로그와 현재 WebUI 페이지를 기준으로 확인해야 합니다.

기본 사용流程

1. Python 3.11, 가상 환경 및 프로젝트 종속성이 준비되었는지 확인합니다.
2. .env.example에서 .env를 생성하고 자신의 실행 구성을 입력합니다.
3. python web.py로 로컬 관리 페이지를 시작합니다.
4. WebUI에서 사용 권한이 있는 이메일 서비스와 프록시를 구성합니다.
5. 로컬 환경에 따라 프로토콜 기반 또는 브라우저 기반 방식을 선택합니다.
6. 작업 실행 후 결과와 로그를 확인하여 이메일, 프록시 및 드라이버 단계가 정상인지 확인합니다.

전체 PowerShell 시작 예시는 다음과 같습니다.

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
python web.py

프로토콜 등록 구성 요소 단독 사용

프로토콜 등록 구성 요소는 vendor/gpt-register-tool/协议에 있습니다. 메인 WebUI와 분리하여 단독으로 실행하려면 해당 디렉터리로 이동해 구성 요소 자체의 안내를 읽고 요구되는 종속성을 설치하세요.

이 디렉터리의 구성 요소는 독립적인 상위 프로젝트 출처, 라이선스 및 저작권 표시를 가질 수 있습니다. 사용하기 전에 자체 문서와 라이선스 파일도 확인해야 하며, 메인 프로젝트의 설치 방식과 라이선스가 모든 내용을 포괄한다고 간주해서는 안 됩니다.

고급 사용 및 유지 관리 권장 사항

먼저 로그와 구성에서 문제 확인

등록 프로세스는 이메일 제공업체, 프록시 서비스 및 브라우저 환경에 의존합니다. 어느 한쪽에서 인터페이스를 변경하거나 네트워크 변동이 발생하거나 클라이언트 동작을 조정하면 프로세스가 실패할 수 있습니다. 문제가 발생하면 다음 순서로 확인할 수 있습니다.

1. 전체 로그를 확인하여 가장 먼저 발생한 오류를 찾습니다.
2. .env와 WebUI의 구성을 대조합니다.
3. 이메일 서비스에 여전히 접속할 수 있는지 확인합니다.
4. 프록시 자격 증명, 네트워크 연결 및 안정성을 확인합니다.
5. 브라우저 드라이버를 사용하는 경우 브라우저 또는 공급업체 클라이언트가 올바르게 설치되고 실행 중인지 확인합니다.
6. 프로토콜 구성 요소를 사용하는 경우 해당 디렉터리의 종속성과 상위 프로젝트 안내를 확인합니다.

로컬 실행 데이터 보호

이메일 풀, 프록시 자격 증명, 계정 데이터베이스, 브라우저 프로필, 로그 및 내보낸 파일은 모두 로컬 실행 데이터입니다. 이러한 파일에는 민감한 정보가 포함될 수 있으므로 공개 또는 공유 저장소에 커밋해서는 안 됩니다.

프로젝트의 .gitignore가 일반적인 데이터 파일을 제외하고 있더라도 코드를 커밋하기 전에 커밋 대상을 직접 확인해야 합니다. 자격 증명 보호를 파일 이름이나 무시 규칙에만 의존하지 마세요.

유효한 문제 보고서 작성

프로젝트에 Issue 또는 Pull Request를 제출해야 한다면 충분한 진단 정보를 함께 제공하세요.

• 전체 또는 핵심 오류 내용.
• 운영 체제, Python 버전 및 관련 실행 환경.
• 재현 가능한 단계.
• 프로토콜 기반 드라이버와 브라우저 기반 드라이버 중 어떤 방식을 사용하는지.
• 비밀번호, 토큰 및 프록시 자격 증명을 숨긴 필수 구성 설명.

실제 자격 증명을 공개적으로 붙여 넣지 마세요. 명확한 환경 정보와 재현 단계가 단순히 “작동하지 않음”이라고 설명하는 것보다 문제를 찾는 데 더 도움이 됩니다.

타사 종속성 변경 사항 확인

이메일 인터페이스, 프록시 네트워크 및 브라우저 공급업체 클라이언트는 독립적으로 변경될 수 있습니다. 프로젝트는 이러한 단계를 구성과 드라이버로 분리하여 자신의 환경에 맞게 조정할 수 있도록 하지만, 이러한 설계가 타사 변경으로 인한 오류를 없애 주지는 않습니다. 업그레이드하거나 수정하기 전에 현재 사용 가능한 구성을 보존하고 단계별로 검증하는 것이 좋습니다.

라이선스 및 사용 범위

메인 프로젝트는 xiaoguzuiniu/gpt-free-register를 기반으로 수정되었으며 MIT License에 따라 배포됩니다. 구체적인 내용은 저장소의 LICENSE를 기준으로 합니다.

vendor/gpt-register-tool/协议의 구성 요소는 각 상위 프로젝트의 라이선스와 저작권 표시를 유지합니다. 이러한 구성 요소를 배포, 수정 또는 배포 환경에 적용하기 전에 각각의 라이선스 요구 사항을 확인해야 합니다.

요약

Turb GPT Register는 이메일, 프록시, 프로토콜 구성 요소 및 브라우저 드라이버를 로컬 작업 흐름에 통합하고 WebUI를 통해 통합 관리 기능을 제공합니다. 사용하기 전에 Python 3.11 환경, 종속성 및 .env 구성을 완료한 다음, 합법적으로 권한을 가진 환경에 맞는 드라이버 방식을 선택해야 합니다. 문제가 발생하면 먼저 로그, 구성 및 타사 서비스 상태를 확인하고 모든 로컬 자격 증명과 실행 데이터를 적절히 보호하세요.