서버 없이 영구적인 Microsoft QR 코드 생성

1.9K 00

일반 소개

서버리스 QR코드 허브는 WeChat 그룹 채팅에서 QR코드가 자주 실패하는 문제를 해결하기 위해 설계된 오픈 소스 도구입니다. 이 도구는 기존 서버를 실행할 필요 없이 Cloudflare Workers와 D1 데이터베이스를 기반으로 합니다. 사용자는 그룹 채팅 관리를 용이하게 하기 위해 영구적으로 유효한 WeChat 그룹 QR 코드를 생성하는 동시에 짧은 링크에 대한 긴 링크를 지원할 수 있습니다. 이 프로젝트는 사용자가 언제든지 QR코드 또는 짧은 링크 콘텐츠를 업데이트할 수 있는 관리 백엔드를 제공하며, 사용자 지정 스타일과 비밀번호 보호를 지원합니다. 배포가 간단하고 무료 할당량으로 매일 사용하기에 충분하며 개인, 팀 또는 개발자에게 적합합니다. 이 코드는 GitHub에서 공개적으로 사용할 수 있으며 커뮤니티에서 자유롭게 최적화하고 확장할 수 있습니다.

기능 목록

WeChat 그룹 채팅에 영구적으로 유효한 QR 코드를 생성하여 실패 문제를 해결하세요.
긴 링크를 짧은 링크로 변환하여 쉽게 공유하고 배포할 수 있습니다.
색상, 테두리 및 로고를 포함한 사용자 지정 QR 코드 스타일을 지원합니다.
관리 백엔드를 제공하여 언제든지 QR코드 또는 짧은 링크의 콘텐츠를 업데이트할 수 있습니다.
무단 액세스를 제한하는 비밀번호 보호 기능을 지원합니다.
클라우드플레어 워커 및 D1 데이터베이스를 기반으로 하며 서버가 필요하지 않습니다.
사용자 수정 및 확장을 지원하는 오픈 소스 코드.
만료된 데이터를 자동으로 정리하여 시스템을 효율적으로 유지하세요.

도움말 사용

설치 및 배포

서버리스-QR코드-허브는 Cloudflare Workers 플랫폼을 사용하여 실행되며 기존 서버가 필요하지 않습니다. 자세한 배포 단계는 다음과 같습니다:

Cloudflare 계정 가입
무료 계정에 가입하려면 Cloudflare 웹사이트를 방문하세요. 기존 계정은 바로 로그인할 수 있습니다.
D1 데이터베이스 만들기
Cloudflare 대시보드에 로그인하고 작업자 및 페이지 > D1 > 데이터베이스 생성으로 이동합니다.
- 데이터베이스의 이름을 지정합니다(예 qrcode-db.
- 생성 후 데이터베이스 ID를 복사하여 나중에 사용하세요.
포크 GitHub 리포지토리
인터뷰 프로젝트 웨어하우스그런 다음 오른쪽 상단의 "포크" 버튼을 클릭하여 리포지토리를 GitHub 계정에 복사합니다.
컴파일러 wrangler.toml
Fork 리포지토리에서 포크 저장소에서 wrangler.toml 파일에서 편집 버튼을 클릭합니다. 파일에서 [d1_databases] 부분적으로는 다음과 같습니다. database_id 2단계에서 복사한 D1 데이터베이스 ID로 바꿉니다. 예시:
```
[[d1_databases]]
binding = "DB"
database_name = "qrcode-db"
database_id = "<你的数据库ID>"
```
변경 내용을 저장하고 커밋합니다.
클라우드플레어 워커 만들기
Cloudflare 대시보드로 돌아가서 워커 및 페이지 > 워커 생성을 선택합니다.
- 작업자의 이름을 지정합니다(예 qrcode-hub.
- 구성 > Git 통합을 클릭하고 작업 중인 GitHub 리포지토리를 선택합니다.
- '저장 및 배포'를 클릭합니다.
사용자 정의 도메인 이름 바인딩(선택 사항)
배포가 성공적으로 완료되면 Cloudflare는 기본 제공 *.workers.dev 도메인 이름. 더 빠른 액세스 또는 브랜딩이 필요한 경우:
- "작업자" > "트리거" > "사용자 지정 도메인 추가"로 이동합니다.
- Cloudflare에서 호스팅되는 하위 도메인을 입력합니다(예 qr.example.com).
- 지시에 따라 DNS 구성을 완료합니다.
액세스 비밀번호 설정
Cloudflare 대시보드에서 작업자 설정으로 이동하여 환경 변수 섹션을 찾습니다. 변수를 추가합니다. PASSWORD값은 사용자 지정 비밀번호(문자와 숫자의 조합(예: 다음과 같은 두 개의 UUID 문자열)이 권장됨)입니다. a1b2c3d4-e5f6g7h8). 저장 후 관리 백엔드에 액세스하려면 이 비밀번호를 입력해야 합니다.
배포 검증
배포가 완료된 후 할당된 *.workers.dev 도메인 또는 사용자 정의 도메인을 선택합니다. 로그인 페이지가 표시되면 배포가 성공한 것입니다.

업그레이드 지침

무료 할당량 제한으로 인해 이전 버전의 프로젝트(Cloudflare KV 기반, 버전 v1.2.0 이하)는 더 이상 권장되지 않습니다. 새 버전은 D1 데이터베이스를 기반으로 하며 보다 안정적인 성능을 위해 5백만 읽기를 지원합니다.

마이그레이션 가이드참조 MIGRATE.md.
이전 버전의 문서: 보기 README.v1.md.

주요 기능 사용

배포가 완료되면 사용자는 브라우저를 통해 도구에 액세스할 수 있습니다. 다음은 자세한 작동 절차입니다:

영구적인 Microsoft QR 코드 생성

관리 배경에 액세스
작업자 도메인을 엽니다(예 https://qrcode-hub.<你的账户>.workers.dev) 또는 사용자 지정 도메인 이름을 입력합니다. 설정한 비밀번호를 입력하여 로그인합니다.
위챗 링크 추가
관리 배경에서 'WeChat QR 코드 추가'를 클릭합니다.
- WeChat 그룹 채팅의 원본 링크(일반적으로 임시 QR코드 링크)를 입력합니다.
- 선택 사항으로 로고를 업로드할 수 있습니다(100x100픽셀 미만의 PNG/JPG 형식 권장).
- QR코드 색상 또는 테두리를 조정합니다(기본값은 검은색 전경, 흰색 배경).
- "생성"을 클릭합니다.
QR코드 및 짧은 링크 받기
시스템은 QR코드 이미지와 짧은 링크(예 https://qr.example.com/abc123) QR 코드를 스캔하여 그룹 채팅에 바로 참여하면 짧은 링크를 WeChat 또는 다른 플랫폼에 공유할 수 있습니다.
그룹 채팅 링크 업데이트
원래 그룹 채팅 링크가 작동하지 않는 경우 관리 백그라운드로 이동하여 해당 QR코드 레코드를 찾아 새 그룹 채팅 링크로 업데이트합니다. 업데이트 후에도 QR코드와 짧은 링크는 변경되지 않으므로 사용자가 다시 공유할 필요가 없습니다.

URL 단축 서비스

긴 링크 추가
관리자 패널에서 '공통 쇼트링크 추가'를 클릭합니다.
- 긴 링크(예: 기사, 파일 다운로드 주소)를 붙여넣습니다.
- 선택적으로 사용자 지정 가능한 짧은 링크 접미사(예 abc123).
- "생성"을 클릭합니다.
짧은 링크 받기
클릭하면 짧은 링크를 반환하여 원래 페이지로 이동하는지 테스트할 수 있습니다. 짧은 링크는 소셜 미디어, 이메일 및 기타 시나리오에서 사용할 수 있습니다.
짧은 링크 관리
관리자 백엔드에서 모든 짧은 링크를 확인하고, 점프 레코드의 편집, 삭제 또는 보기를 지원합니다.

맞춤형 QR코드 스타일

모양 조정
QR 코드를 추가할 때 '고급 옵션'을 클릭합니다.
- 로고 업로드(브랜딩 강화)
- 전경색과 배경색을 선택합니다(높은 대비와 스캔의 용이성을 보장하기 위해).
- 테두리 너비 또는 둥근 모서리 효과를 설정합니다.
미리 보기 및 저장
'미리보기'를 클릭하여 효과를 확인한 후 확인하여 최종 QR 코드를 생성합니다.

비밀번호 보호 관리

관리 백엔드에 액세스할 때마다 배포 시 설정한 비밀번호를 입력해야 합니다.
비밀번호를 변경하려면 Cloudflare 대시보드에서 비밀번호를 업데이트하세요. PASSWORD 환경 변수를 설정하고 워커를 다시 배포합니다.

주의

배급Cloudflare Workers 무료 계정은 하루에 100,000건의 요청을 제공하며, D1 데이터베이스는 개인용으로 충분한 5백만 건의 읽기를 지원합니다. 트래픽이 많은 시나리오의 경우 유료 요금제로 업그레이드할 수 있습니다.
백업D1 데이터베이스에는 모든 QR코드 및 단축 링크 데이터가 저장되며, 정기적으로 백업을 내보내는 것이 좋습니다(Cloudflare 대시보드를 통해 작동).
도메인 속도: 기본값 *.workers.dev 일부 액세스 영역의 도메인 이름이 느린 경우 사용자 지정 도메인 이름을 바인딩하는 것이 좋습니다.
보증인비밀번호는 유출되지 않도록 충분히 복잡해야 합니다. 짧은 링크와 QR 코드의 콘텐츠는 합법적이고 규정을 준수해야 합니다.

샘플 작업

짧은 링크 만들기: 입력 https://example.com/long-url생성 https://qr.example.com/xyz789를 클릭하고 테스트 점프를 클릭합니다.
WeChat용 QR 코드 생성그룹 채팅 링크를 입력하고 로고를 업로드한 다음 QR 코드를 생성하고 이미지를 저장하여 위챗 그룹 또는 친구 서클에 공유할 수 있습니다.
레코드 업데이트관리 배경에서 QR코드 기록을 찾아 유효하지 않은 링크를 교체하고 사용자가 원본 QR 코드를 계속 사용할 수 있는지 확인합니다.

이 단계를 통해 사용자는 서버리스 QR코드 허브를 신속하게 배포하여 영구적인 QR코드 또는 짧은 링크를 생성할 수 있습니다. 관리 백엔드는 직관적이며 프로그래밍 경험이 없어도 시작할 수 있습니다.

애플리케이션 시나리오

WeChat 그룹 관리
그룹 관리자는 그룹 채팅의 QR 코드를 오랫동안 공유해야 하는데, 서버리스 QR코드 허브는 영구적인 QR 코드를 생성하여 자주 변경하는 수고를 덜고, 멤버들은 언제든지 코드를 스캔하여 참여할 수 있습니다.
마케팅 활동
판매자는 이벤트 등록 링크를 짧은 링크와 QR 코드로 변환하여 전단지에 인쇄하거나 소셜 미디어에 게시할 수 있습니다. 맞춤형 로고로 브랜딩을 강화하고 관리자 패널에서 언제든지 링크를 업데이트할 수 있습니다.
콘텐츠 공유
블로거나 크리에이터는 기사 및 동영상 링크를 단축하고 QR 코드를 생성하여 명함이나 포스터에 삽입하여 팬들이 쉽게 액세스할 수 있도록 합니다.
교육 및 훈련
교육 기관은 코스 링크를 QR 코드로 변환하여 교과서나 광고에 인쇄합니다. 학생은 코드를 스캔하여 등록할 수 있으며 링크 업데이트는 QR 코드 사용에 영향을 주지 않습니다.
오픈 소스 프로젝트 홍보
개발자는 GitHub 리포지토리 링크를 짧은 링크로 바꾸고, QR 코드를 생성하여 커뮤니티나 문서에 공유하여 쉽게 액세스할 수 있습니다.

QA

생성된 QR 코드가 무효화되나요?
Cloudflare Workers와 D1 데이터베이스가 제대로 작동하는 한, QR 코드는 영원히 유효합니다. 원래 그룹 채팅 링크가 작동하지 않더라도 관리자 백엔드를 통해 업데이트할 수 있으며 QR 코드를 교체할 필요가 없습니다.
배포하려면 프로그래밍 경험이 필요한가요?
필요 없습니다. 배포는 단계별 작업일 뿐이며 관리 백엔드 인터페이스는 친숙하고 제로 베이직 사용자에게 적합합니다.
무료 계정으로 충분하나요?
개인 또는 소규모 팀에게는 Cloudflare 무료 할당량(하루 100,000건의 요청, 5백만 건의 데이터베이스 읽기)으로 충분합니다. 트래픽이 많은 시나리오에서는 유료 요금제를 고려할 수 있습니다.
데이터를 어떻게 안전하게 보호하나요?
데이터는 D1 데이터베이스에 저장되며 비밀번호는 관리 백엔드를 보호합니다. 데이터베이스를 정기적으로 백업하고 복잡한 비밀번호를 설정하는 것이 좋습니다.
어떤 링크가 지원되나요?
WeChat 링크, 웹 페이지, 파일 다운로드 등 모든 합법적인 URL을 지원합니다. 생성하기 전에 링크 유효성을 테스트하는 것이 좋습니다.
이전 사용자는 어떻게 업그레이드하나요?
상담 MIGRATE.md새 버전의 코드는 KV 데이터를 D1 데이터베이스로 마이그레이션하여 다시 배포되었습니다.