OpenQR

OpenQR

Trình tạo mã QR miễn phí, mã nguồn mở, không hình mờ. Chạy hoàn toàn trong trình duyệt của bạn — không theo dõi, không đăng ký, không giới hạn.

Hầu hết các trình tạo mã QR trực tuyến dụ bạn bằng "miễn phí" rồi sau đó thêm hình mờ, giới hạn kích thước tải xuống, giấu xuất vector đằng sau tường phí, hoặc định tuyến mã của bạn qua máy chủ của họ để nó chết khi bạn ngừng trả phí. Mã QR chỉ là một tiêu chuẩn mở (ISO/IEC 18004) không tốn chi phí để tạo. OpenQR giữ nguyên điều đó.

Kho lưu trữ này là công cụ tạo cơ bản — bản triển khai tham chiếu mã nguồn mở. Nó được thiết kế nhỏ gọn và dễ fork.

Phiên bản lưu trữ: API miễn phí, máy chủ MCP và mã có thể chỉnh sửa

Mọi thứ trong kho lưu trữ này đều miễn phí và sẽ luôn miễn phí, không hình mờ và không hết hạn. Bản dựng lưu trữ tại openqr.uk thêm lớp tài khoản tùy chọn cho những người muốn mã có thể chỉnh sửa và tự động hóa:

• Mã QR động / có thể chỉnh sửa với phân tích quét. Thay đổi đích đến sau khi bạn đã in. 3 mã miễn phí trên tài khoản miễn phí (7 ngày quét theo quốc gia); không giới hạn trên gói Pro với giá £9/tháng hoặc £72/năm, cũng mở khóa lịch sử phân tích đầy đủ, chi tiết thị trấn và khu vực, phân tích thiết bị và nguồn giới thiệu với xuất CSV, tên miền phụ có thương hiệu và mã được bảo vệ bằng mật khẩu.
• API REST miễn phí. Tạo mã và quản lý mã động theo chương trình. Đặc tả OpenAPI tại /openapi.json; tài liệu tương tác tại openqr.uk/api.
• Máy chủ MCP lưu trữ tại https://openqr.uk/mcp (Streamable HTTP, 17 công cụ). Tạo và quản lý mã QR trực tiếp từ Claude, Cursor hoặc bất kỳ máy khách MCP nào. Được liệt kê trong MCP Registry chính thức. Máy khách hỗ trợ từ xa kết nối trực tiếp đến URL đó; máy khách chỉ dùng stdio có thể cầu nối đến nó với npx -y @open-qr/mcp và OPENQR_API_KEY được đặt (chi tiết).

Trình tạo tĩnh trong kho lưu trữ này không bao giờ gọi bất kỳ điều nào ở trên. Nó luôn 100% phía máy khách (xem Quyền riêng tư) và không có điều nào trong số đó bắt buộc để sử dụng hoặc tự lưu trữ trình tạo.

Công cụ

Máy chủ MCP lưu trữ tại https://openqr.uk/mcp hiển thị 17 công cụ này. Mọi công cụ đều yêu cầu khóa API miễn phí — tạo tại openqr.uk/api và truyền nó dưới dạng Authorization: Bearer oqr_... trên kết nối MCP.

Công cụ	Chức năng
generate_qr	Tạo mã QR tĩnh từ bất kỳ văn bản hoặc URL nào. Trả về hình ảnh PNG hoặc đánh dấu SVG.
create_dynamic_qr	Tạo mã QR có thể chỉnh sửa mà bạn có thể thay đổi đích đến sau này mà không cần in lại.
update_dynamic_qr	Thay đổi đích đến, nhãn, liên kết ngắn tùy chỉnh, thẻ hoặc thư mục của mã động.
get_dynamic_qr	Lấy chi tiết đầy đủ của một mã: đích đến, liên kết ngắn, nhãn, loại, thẻ, thư mục, trạng thái, ngày tạo.
get_scans	Thống kê quét cho mã động.
list_dynamic_qr	Liệt kê các mã động của bạn với id, URL ngắn, đích đến, nhãn và trạng thái.
delete_dynamic_qr	Xóa vĩnh viễn mã động. Liên kết ngắn của nó ngừng hoạt động.
bulk_create_dynamic_qr	Tạo tối đa 200 mã động cùng lúc.
list_folders	Liệt kê các thư mục của bạn.
create_folder	Tạo thư mục để tổ chức mã.
delete_folder	Xóa thư mục. Các mã trong đó được bỏ phân loại, không bị xóa.
list_themes	Liệt kê các chủ đề kiểu đã lưu. Áp dụng một chủ đề bằng cách truyền id hoặc tên của nó dưới dạng theme.
create_theme	Lưu chủ đề kiểu tái sử dụng (màu sắc, kiểu chấm và góc).
delete_theme	Xóa chủ đề đã lưu. Các mã đã được tạo kiểu với nó vẫn giữ nguyên giao diện.
get_subdomain	Hiển thị tên miền phụ có thương hiệu trên tài khoản và liệu nó có bị đình chỉ hay không.
set_subdomain	Yêu cầu hoặc thay đổi tên miền phụ có thương hiệu để mã cũng phân giải tại {name}.oqr.to. Chỉ dành cho Pro.
clear_subdomain	Giải phóng tên miền phụ có thương hiệu. Các mã vẫn hoạt động trên liên kết ngắn thông thường.

Nó cũng hiển thị 5 tài nguyên và 4 lời nhắc:

• Tài nguyên là các cài đặt trước kiểu QR tích hợp tại openqr://preset/classic, /teal, /high-contrast, /dots và /classy. Đọc một cái và truyền kiểu của nó cho create_theme.
• Lời nhắc là create_tracked_qr, bulk_qr_for_print, brand_a_qr và qr_scan_report.

Tính năng

• Không hình mờ, không giới hạn kích thước, không đăng ký — mọi tính năng đều miễn phí
• Riêng tư theo thiết kế — mã được tạo hoàn toàn trong trình duyệt của bạn; nội dung không bao giờ chạm đến máy chủ
• Xuất ở mọi nơi — PNG / WebP lên đến 4096px, cộng với SVG và PDF vector thực
• Tạo kiểu đầy đủ — màu sắc, gradient, kiểu chấm & góc, nhúng logo, khung "Quét tôi"
• Nhập thông minh — dán liên kết hoặc văn bản và loại được tự động phát hiện
• Tải trọng phong phú — URL, văn bản, email, điện thoại, SMS, WhatsApp, Wi-Fi và trình chọn vị trí dựa trên bản đồ
• Sao chép một cú nhấp chuột, liên kết thiết kế có thể chia sẻ, sáng/tối, phản hồi, truy cập bằng bàn phím

Bắt đầu nhanh

pnpm install
pnpm dev        # http://localhost:3011

Xây dựng & tự lưu trữ

pnpm build
pnpm start      # serves on :3011 (standalone output)

Đây là ứng dụng Next.js tiêu chuẩn — lưu trữ ở bất kỳ đâu (VPS, Raspberry Pi, Cloudflare, đằng sau bất kỳ proxy ngược nào). Nó không cần biến môi trường, không cần cơ sở dữ liệu, không cần bí mật để chạy.

Nhúng

Thành phần <Generator/> tự chứa và có thể cấu hình:

import { Generator } from "@/components/generator/generator";

// Full page (default OpenQR logo header):
<Generator />

// Embedded widget, your own branding, no default header:
<Generator embedded header={<MyLogo />} />

// Inject your own post-download call-to-action:
<Generator renderSuccess={(variant) => <MySupportCluster variant={variant} />} />

Công cụ đi kèm không phân tích. Nếu bạn muốn sự kiện UI ẩn danh (ví dụ: định dạng xuất nào được sử dụng — không bao giờ là nội dung QR), hãy chèn một trình xử lý:

import { setTrackHandler } from "@/lib/analytics";
setTrackHandler((action, name, category) => myAnalytics.track(category, action, name));

Quyền riêng tư

Việc tạo QR diễn ra 100% trong trình duyệt của bạn. Các cuộc gọi đi tùy chọn duy nhất là trong công cụ Vị trí: các ô bản đồ từ CARTO và tra cứu địa chỉ qua Nominatim của OpenStreetMap. Không có gì khác rời khỏi thiết bị.

Ngăn xếp công nghệ

Next.js 16 (App Router) · React 19 · TypeScript (nghiêm ngặt) · Tailwind v4 · qr-code-styling · Leaflet · pnpm.

Đóng góp

Xem CONTRIBUTING.md. Giữ nó đơn giản, dễ truy cập, phía máy khách và miễn phí — không tính năng nào nên yêu cầu thanh toán để xóa hình mờ hoặc mở khóa một định dạng.

Giấy phép

AGPL-3.0 © 2026 Sam Moreton.

Bạn được tự do sử dụng, nghiên cứu, sửa đổi, tự lưu trữ và phân phối lại OpenQR theo AGPL-3.0. Nếu bạn chạy phiên bản đã sửa đổi như một dịch vụ mạng, AGPL yêu cầu bạn cung cấp mã nguồn của mình theo cùng giấy phép. Nếu điều đó không phù hợp với trường hợp sử dụng của bạn, giấy phép thương mại có sẵn — xem NOTICE.