웹솔루션개발 26년 노하우! 해피CGI의 모든것

[해피CGI][cgimall] Pentest-Tools Port Scanner with Nmap - 온라인 포트 스캐너 및 네트워크 점검 도구

해피CGI윤실장 — Mon, 10 Aug 2026 09:06:05 +0900

Pentest-Tools Port Scanner with Nmap은 별도의 프로그램 설치 없이 웹브라우저에서 사용할 수 있는 온라인 포트 스캐너입니다.
Nmap 기반으로 동작하며, 서버나 네트워크 장비에서 외부에 노출된 포트와 실행 중인 서비스를 확인하는 데 활용할 수 있습니다.

일반적으로 서버를 운영하다 보면 SSH, FTP, HTTP, HTTPS, DB, 메일, 원격접속 포트 등이 외부에 열려 있는지 점검해야 할 때가 있습니다.
이 도구를 사용하면 특정 도메인, IP 주소, 네트워크 대역을 대상으로 포트 상태를 확인하고,
방화벽 설정이나 불필요한 서비스 노출 여부를 점검할 수 있습니다.

주요 기능은 다음과 같습니다.

* TCP 포트 스캔

* UDP 포트 스캔

* 주요 포트 빠른 스캔

* 전체 포트 범위 심층 스캔

* 서비스 버전 탐지

* 운영체제 탐지 옵션

* 열려 있는 포트 및 서비스 정보 확인

* 결과를 CSV, JSON, PDF 형식으로 내보내기

* 웹브라우저 기반 실행으로 별도 설치 불필요

이 도구는 서버 보안 점검, 방화벽 정책 확인, 외부 노출 서비스 점검, 취약점 진단 전 사전 조사 단계에서 유용하게 사용할 수 있습니다.
예를 들어 22번 SSH, 80번 HTTP, 443번 HTTPS, 3306번 MySQL, 3389번 RDP와 같은 포트가
의도한 대로만 열려 있는지 확인할 수 있습니다.

특히 로컬 PC에 Nmap을 설치하거나 명령어를 직접 입력하기 어려운 경우에도 브라우저에서 간단히 실행할 수 있어,
서버 관리자나 웹사이트 운영자가 기본적인 네트워크 노출 상태를 확인하는 용도로 활용하기 좋습니다.

다만 포트 스캔은 대상 서버에 네트워크 요청을 발생시키는 행위이므로,
반드시 본인 소유의 서버나 사전에 허가받은 대상에만 사용해야 합니다.
타인의 서버나 서비스에 무단으로 스캔을 수행할 경우 보안 정책 위반 또는 법적 문제가 발생할 수 있습니다.

검사 결과에서 불필요하게 열린 포트가 확인된다면
방화벽 설정, 서버 데몬 실행 상태, 포트 포워딩, 접근제어 정책 등을 함께 점검하는 것이 좋습니다.
포트가 열려 있다는 사실만으로 즉시 취약하다고 단정할 수는 없지만,
외부에 노출된 서비스는 공격 표면이 될 수 있으므로 주기적인 확인이 필요합니다.

[해피CGI][cgimall] Dotcom-Tools - 웹사이트 속도, 성능, 접속 상태를 확인할 수 있는 온라인 진단 도구

해피CGI윤실장 — Fri, 7 Aug 2026 09:09:55 +0900

Dotcom-Tools는 웹사이트 운영자, 개발자, 서버 관리자 등이 사이트의 접속 상태와 성능을 확인할 때 사용할 수 있는 온라인 기반 진단 도구입니다.

별도의 프로그램 설치 없이 웹브라우저에서 바로 사용할 수 있으며,
웹사이트 속도 테스트, Ping 테스트, DNS 조회, Traceroute, SSL 인증서 확인, 포트 체크, HTTP 헤더 확인 등
다양한 네트워크 및 웹 성능 관련 기능을 제공합니다.

특히 웹사이트 속도 테스트 기능은 여러 지역에서 사이트 접속 속도를 확인할 수 있어,
실제 사용자 환경에 가까운 성능 점검이 가능합니다.

페이지 로딩 시간, 응답 속도, 리소스별 로딩 상태 등을 확인할 수 있기 때문에
사이트가 느리게 열리는 원인을 파악하는 데 도움이 됩니다.

로그인 없이 무료로 3개 지역까지 선택이 가능 합니다.

Dotcom-Tools는 다음과 같은 경우에 활용하기 좋습니다.

- 웹사이트가 정상적으로 접속되는지 확인할 때

- 특정 지역에서 사이트 접속이 느린지 확인할 때

- DNS 설정이 정상적으로 적용되었는지 확인할 때

- 서버 응답 속도나 네트워크 경로를 점검할 때

- SSL 인증서 상태를 확인할 때

- 웹페이지 로딩 속도와 병목 요소를 분석할 때

운영 중인 홈페이지, 쇼핑몰, 커뮤니티, 웹솔루션 등의 속도 저하나 접속 장애 원인을 점검할 때 유용하며,
개발 및 유지보수 과정에서도 기본적인 진단 도구로 활용할 수 있습니다.

다만 Dotcom-Tools는 진단 결과를 제공하는 도구이므로, 실제 서버 최적화나 소스 수정은 별도로 진행해야 합니다.
결과값을 참고하여 이미지 용량, 스크립트 로딩, 서버 응답 속도, DNS 설정, SSL 설정 등을 점검하는 방식으로 활용하는 것이 좋습니다.

[해피CGI][cgimall] 영화급 영상 생성 AI - Kling AI (클링 AI)

해피CGI윤실장 — Thu, 6 Aug 2026 09:07:05 +0900

[개요]

Kling AI는 한 줄의 텍스트(Prompt)나 한 장의 사진을 활용해 최대 2~3분 길이의 영화 수준 1080p 고화질 동영상을 제작하는 최첨단 영상 생성(Text/Image-to-Video) 플랫폼입니다. 글로벌 시장에서 OpenAI의 Sora 등과 경쟁하며 창작자들에게 가장 각광받는 툴 중 하나입니다.

[주요 특징 및 장점]

- 정교한 물리 법칙 시뮬레이션: 자체 개발한 물리 엔진을 통해 중력, 마찰력, 관성, 빛의 반사 등을 계산하여 AI 영상 특유의 어색함이나 '흐물거림' 없이 극도로 자연스러운 모션을 구현합니다.

- 압도적인 영상 길이와 해상도: 기본 5~10초의 짧은 클립을 넘어 '영상 이어쓰기(Video Extension)' 기능으로 최대 2~3분까지 이야기를 확장할 수 있으며, 1080p 고해상도 출력을 지원합니다.

- 강력한 제어 툴 (모션 브러시 & 립싱크): 영상 내에서 특정 부위만 움직이도록 지정하는 '모션 브러시' 기능과 오디오 대사에 맞춰 캐릭터의 입 모양을 동기화하는 '립싱크(Lip Sync)' 같은 고급 편집 기능을 제공합니다.

[추천 활용 사례]

- 숏폼 콘텐츠 및 SNS 마케팅 영상: 유튜브 쇼츠, 인스타그램 릴스, 틱톡 등에 쓰일 감각적이고 몰입감 높은 광고 소재 및 크리에이티브 영상 제작.

- 이미지 기반 영상화: 미드저니 등으로 뽑은 고퀄리티 캐릭터/제품 사진에 생명력을 불어넣어 살아 움직이는 시네마틱 무비나 언박싱 연출 영상 제작.

- 영화/뮤직비디오 콘셉트 스토리보드: 영상 제작 전 시각적인 아이디어나 구도를 빠르게 확인하기 위한 프리비즈(Pre-visualization) 작업.

[가격 및 플랜]

플랜명	월 요금 (정상가)	제공 크레딧 / 핵심 혜택	추천 대상
Free	$0	• 매일 66 크레딧 제공 (24시간 후 소멸) • 최대 5초, 저화질(360p~540p), 워터마크 있음	결제 전 화질과 물리 엔진 성능을 테스트할 유저
Standard	$10 / 월 (연 결제 시 $6.60)	• 월 660 크레딧 • 워터마크 제거, 상업적 이용 가능, 1080p 화질	주 1~2회 가볍게 고화질 영상을 뽑아보는 취미 창작자
Pro	$37 / 월 (연 결제 시 $24.42)	• 월 3,000 크레딧 • 대기 시간 단축(우선 처리), 일괄(Batch) 생성, 고급 카메라 제어	유튜브 숏츠, 인스타 릴스 등을 주기적으로 올리는 크리에이터
Premier	$92 / 월 (연 결제 시 $60.72)	• 월 8,000 크레딧 • 최고 수준의 서버 우선권, 모든 신기능 우선 제공	영상 외주 작업을 하거나 대량 생성이 필요한 대형 채널
Ultra	$180 / 월	• 월 26,000 크레딧 • 스튜디오급 대용량 생성 (※ 연간 할인 없음)	매일 수십 편의 고화질 비디오를 뽑아내야 하는 전문 스튜디오

[해피CGI][cgimall] AI 자율 에이전트 서비스 - Manus (마누스)

해피CGI윤실장 — Wed, 5 Aug 2026 09:05:53 +0900

[개요]

Manus는 단순히 질문에 텍스트나 이미지로 답하는 기존 챗봇을 넘어, 사용자가 설정한 목표를 위해 AI가 스스로 인터넷 브라우저를 조작(검색, 클릭, 타이핑 등)하며 미션을 완수하는 '범용 AI 에이전트(Universal Agent)' 플랫폼입니다. 백엔드로 Anthropic의 최신 최적화 모델 등을 활용하여 복잡한 다단계 업무를 사람 대신 처리합니다.

[주요 특징 및 장점]

- 완전 자율 웹 브라우징: 가상 환경의 브라우저를 AI가 직접 제어하여 실시간 정보 탐색, 웹 스크래핑(자료 수집), 데이터 분석을 혼자서 수행합니다.

- 다단계 워크플로우 수행: '정보 검색 ➡️ 데이터 가공 ➡️ 엑셀 파일 작성 및 시각화'처럼 인간이 컴퓨터로 하던 연속적인 노가다 작업을 하나의 명령으로 자동화합니다.

- 파일 및 결과물 생성: 단순 텍스트 요약이 아니라 가성비 숙소 비교 엑셀 파일, 특정 주제의 PPT 슬라이드, 간단한 웹페이지 코드 등 다운로드 가능한 '진짜 결과물'을 뽑아냅니다.

[추천 활용 사례]

- 시장 조사 및 데이터 수집: "특정 업계의 상위 기업 10곳을 조사하고 매출과 주소지를 엑셀 파일로 정리해 줘"와 같은 리서치 업무.

- 여행 및 일정 기획: 예산, 동선, 개인 취향을 반영하여 실시간으로 숙소 가격과 맛집을 비교 분석한 맞춤형 여행 일정표 작성.

- 코딩 및 웹페이지 프로토타입 빌드: 간단한 이벤트 안내 페이지나 결혼 초대장 같은 웹페이지 구축 및 배포.

[가격 및 플랜]

플랜명	월 요금 (정상가)	제공 크레딧 / 기능	추천 대상
Free	$0	• 월간 크레딧 없음 (일일 300 리프레시 크레딧 제공) • 동시 작업 1개 제한, Manus 1.6 Lite 모델 적용	기능이 궁금한 가벼운 체험 희망자
Standard	$20 / 월	• 월 4,000 크레딧 + 일일 300 리프레시 크레딧 • 동시 작업 20개, 1.6 / 1.6 Max 전용 모델 사용 가능	일상적인 리search나 웹 빌딩이 필요한 1인 유저
Customizable	$40 / 월	• 월 8,000 크레딧 + 일일 300 리프레시 크레딧 • 7일 무료 체험 제공, 맞춤형 에이전트 설정 가능	매일 AI 에이전트를 다방면으로 쓰는 파워 유저
Extended	$200 / 월	• 월 40,000 크레딧 + 일일 300 리프레시 크레딧 • 가장 높은 작업 우선순위 제공	대량의 데이터 수집 및 비즈니스 자동화가 필요한 프리랜서·스타트업
Team	사용자당 $40 / 월	• 팀원 간 크레딧 풀(Pool) 공유 • 데이터 학습 제외(보안), 팀 관리자 기능 제공	협업 및 업무 보안이 중요한 소규모 팀 (최소 2인)

[해피CGI][cgimall] OpenAI 의 개발 에이전트 Codex

해피CGI윤실장 — Tue, 4 Aug 2026 09:07:17 +0900

OpenAI Codex는 대화형 AI로 유명한 GPT-3를 기반으로 개발된 모델로, 프로그래밍 코드 이해와 생성에 특화된 인공지능입니다. OpenAI가 GitHub 등에 공개된 수십억 줄의 소스 코드와 자연어 데이터를 학습시켜, 인간의 언어(영어, 한국어 등)와 컴퓨터의 언어(프로그래밍 언어)를 자유롭게 번역할 수 있도록 만들었습니다.

자연어 → 코드 변환: "파이썬으로 날씨 정보를 가져오는 API를 만들어줘"라고 말하면 해당 기능을 하는 코드를 즉시 작성해 줍니다.
코드 → 자연어 설명: 복잡한 기존 코드를 입력하면 "이 코드는 데이터베이스에서 사용자 정보를 불러와 정렬하는 역할을 합니다"라고 사람이 이해하기 쉽게 설명해 줍니다.
다양한 프로그래밍 언어 지원: Python, JavaScript, TypeScript, Ruby, Go, C++, SQL, Shell 등 10여 개 이상의 주요 언어를 지원합니다.
문맥(Context) 이해: 단순히 한 줄만 짜는 것이 아니라, 기존에 작성된 코드의 흐름과 변수 이름을 파악하여 자연스럽게 이어지는 코드를 제안합니다.

[해피CGI][cgimall] Visual Studio Code 1.122

해피CGI윤실장 — Mon, 3 Aug 2026 09:06:14 +0900

비주얼 스튜디오 1.122 로 업데이트 되었습니다.

https://code.visualstudio.com/updates/v1_122
업데이트 내용은 위의 링크에서 확인이 가능합니다.

이번 릴리스에서는 에이전트 환경이 더욱 향상되었고 BYOK(Bring Your Own Kit)의 유연성이 높아졌으며, 다양한 장치에서 웹 앱을 테스트할 수 있는 새로운 기능이 추가되었습니다.

더 큰 컨텍스트 윈도우 : Anthropic 및 OpenAI 모델에 대해 1M 컨텍스트 윈도우를 지원합니다.

에어갭 방식의 BYOK : 인터넷에 연결되어 있지 않아도 자신만의 언어 모델을 사용할 수 있습니다.

브라우저 기기 에뮬레이션 : 통합 브라우저에서 다양한 기기에 대한 웹사이트 반응성을 직접 테스트할 수 있습니다.

상세한 문제 보고 : 스크린샷 및 비디오 녹화를 포함하여 상세한 VS Code 문제 보고서를 생성합니다.

[해피CGI][cgimall] Qwen.ai – Alibaba Cloud 기반 AI 어시스턴트 서비스

해피CGI윤실장 — Wed, 29 Jul 2026 09:07:43 +0900

Qwen.ai는 Alibaba Cloud의 Qwen 모델을 기반으로 한 AI 서비스로, 대화형 AI, 문서 처리, 이미지·영상 이해, 코드 작성, 검색 보조 등에 활용할 수 있습니다. 일반 사용자는 Qwen Studio를 통해 AI 도우미처럼 사용할 수 있고, 개발자는 API를 통해 서비스에 연동할 수 있습니다.

장점

텍스트뿐 아니라 이미지, 영상, 문서 등 다양한 입력을 처리할 수 있으며, 일부 Qwen 모델은 오픈소스로도 공개되어 활용 범위가 넓습니다. OpenAI API와 호환되는 방식의 API를 제공해 기존 AI 서비스 구조에 비교적 쉽게 연동할 수 있습니다.

단점

글로벌 서비스 기준으로는 ChatGPT, Gemini, Claude에 비해 국내 사용자 정보나 활용 사례가 아직 상대적으로 적습니다. 또한 API 요금, 지원 모델, 국가별 사용 가능 범위가 달라질 수 있어 실제 도입 전 최신 정책 확인이 필요합니다.

요금

Qwen Studio는 공식 사이트에서 무료로 사용할 수 있는 AI 어시스턴트로 안내되어 있습니다. API 사용 시에는 Alibaba Cloud Model Studio 기준으로 입력 토큰과 출력 토큰 사용량에 따라 과금되며, 모델별 단가가 다릅니다. 예를 들어 qwen3-max는 국제 배포 기준 100만 입력 토큰당 약 $1.2, 100만 출력 토큰당 약 $6 수준으로 안내되어 있고, Qwen 오픈소스 계열 모델은 모델과 배포 지역에 따라 100만 입력 토큰당 약 $0.115~$0.6 수준 등으로 차이가 있습니다. 일부 모델은 신규 활성화 후 일정 기간 무료 토큰이 제공될 수 있으나, 모델별·지역별 조건이 다르므로 실제 사용 전 가격표 확인이 필요합니다.

활용

AI 챗봇, 고객문의 자동응답, 문서 요약, 번역, 코드 작성 보조, 이미지 분석, 검색형 AI 서비스 등에 활용할 수 있습니다. 특히 비용을 낮추면서 자체 AI 기능을 붙이려는 서비스나 개발 테스트용 AI 모델 검토에 적합합니다.

[해피CGI][cgimall] TurboScribe AI – 음성·영상 자동 전사 서비스

해피CGI윤실장 — Tue, 28 Jul 2026 09:10:45 +0900

TurboScribe AI는 음성·영상 파일을 AI가 분석해 텍스트로 변환해 주는 자동 전사 서비스입니다.

회의 녹음, 강의 영상, 인터뷰, 유튜브 영상 등을 문서나 자막 형태로 빠르게 정리할 수 있습니다.

간편한 파일 업로드만으로 전사, 번역, 자막 생성 등 다양한 작업에 활용할 수 있습니다.

장점

파일 업로드만으로 쉽게 사용할 수 있으며, 긴 음성·영상도 빠르게 텍스트화할 수 있습니다. 자막 파일 생성, 번역, 화자 구분 등 부가 기능도 지원합니다.

단점

녹음 품질이 낮거나 주변 소음이 많으면 인식 오류가 발생할 수 있습니다. 개인정보나 민감한 내용이 포함된 파일은 외부 서비스 업로드에 대한 보안 검토가 필요합니다.

요금

TurboScribe AI는 무료 플랜과 유료 Unlimited 플랜을 제공합니다. 무료 플랜은 하루 최대 3개 파일까지 사용할 수 있으며, 파일당 최대 30분 길이 제한이 있습니다. 유료 플랜은 월 결제 기준 $20, 연 결제 기준 월 환산 $10 수준이며, 1인 기준 무제한 전사, 파일당 최대 10시간 또는 5GB 업로드, 한 번에 최대 50개 파일 업로드, 번역 및 다양한 내보내기 기능을 지원합니다.

활용

회의록 작성, 강의록 정리, 인터뷰 대본 제작, 영상 자막 생성, 상담 녹취 정리 등에 활용할 수 있습니다. 특히 음성·영상 자료를 빠르게 문서화해야 할 때 유용합니다.

[해피CGI][cgimall] Bootstrap용 원형 다이얼 시간 선택기 플러그인 - jQuery bsTimepicker

해피CGI윤실장 — Mon, 27 Jul 2026 09:28:46 +0900

1. 라이센스

이 플러그인은 MIT 라이센스로 배포됩니다.
개인 및 상업적 프로젝트 모두 자유롭게 사용, 수정, 배포할 수 있습니다.
단, 원본 저작권 표시는 유지해야 합니다.

2. 특징 및 설명

bsTimepicker는 jQuery와 Bootstrap을 기반으로 동작하는 원형 시계 다이얼 방식의 시간 선택기 플러그인입니다. 모바일 알람 앱에서 볼 수 있는 원형 다이얼 UI를 웹 폼에 그대로 구현할 수 있으며, Bootstrap의 드롭다운 컴포넌트를 활용하여 기존 Bootstrap 기반 프로젝트에 자연스럽게 통합됩니다.

지원 환경
jQuery 3.x 이상 / Bootstrap 4.6.x 또는 5.x / Bootstrap Icons

주요 기능

· 24시간(HH:mm) 및 12시간(AM/PM) 표시 모드 지원
· 마우스 클릭 및 터치 드래그로 조작 가능한 원형 시계 다이얼
· input 요소, div 요소, Bootstrap form-floating 컨테이너 모두 지원
· 분 선택 간격 설정 가능 (1분 / 5분 / 10분 / 15분 단위)
· 데이터베이스 저장에 바로 사용 가능한 24시간 형식(HH:mm) 값 반환
· div에 초기화 시 숨김 input 자동 생성 (nameField 옵션)
· 취소 또는 외부 클릭 시 이전 값으로 자동 복원
· 트리거 버튼 스타일, 너비, 아이콘 자유 커스터마이징
· 클리어 버튼 표시 여부 및 레이블 커스터마이징
· minuteInterval 설정 후 자동 닫기 옵션(closeOnSelect)
· show / hide / toggle / setTime / getTime / val / clear / destroy 공개 API 제공
· 초기화, 열림/닫힘, 값 변경 등 세분화된 이벤트 훅 지원

3. 설치 방법 & 사용 방법

설치 방법

아래 순서대로 CSS와 JS 파일을 HTML 문서에 불러옵니다. Bootstrap Icons는 기본 트리거 아이콘에 필수입니다.

기본 사용법 — input 요소 (24시간)

$("#meetingStart").bsTimepicker({

format: "24h"

});

기본 사용법 — input 요소 (12시간 AM/PM)

$("#reminderTime").bsTimepicker({

format: "12h"

});

기본 사용법 — div 요소 (숨김 input 자동 생성)

$("#shiftStart").bsTimepicker({

format: "24h",

defaultTime: "07:30",

nameField: "shift_start",

btnClass: "btn btn-primary",

btnWidth: "200px",

btnEmptyText: "시간을 선택하세요"

});

전체 옵션 목록

format (기본값: "24h") — "24h" 또는 "12h" 중 선택합니다.
minuteInterval (기본값: 5) — 분 선택 단위. 1, 5, 10, 15 중 선택.
defaultTime (기본값: null) — 초기값이 없을 때 사용할 기본 시간. "14:00", "02:00 PM", new Date(), { hour24: 14, minute: 0 } 형식 모두 허용.
nameField (기본값: null) — div에 초기화할 때 생성할 숨김 input의 name 속성값.
title (기본값: "Select time") — 드롭다운 상단에 표시할 제목. null 또는 빈 문자열로 숨길 수 있음.
closeOnSelect (기본값: false) — true로 설정 시 분 선택 후 자동으로 닫힘.
btnClass (기본값: "btn btn-outline-secondary") — 트리거 버튼에 적용할 Bootstrap 클래스.
btnWidth (기본값: null) — 트리거 버튼의 고정 너비. 예: "220px".
btnEmptyText (기본값: "--:--") — 값이 없을 때 트리거에 표시할 안내 문구.
showClearButton (기본값: true) — 클리어 버튼 표시 여부.
clearLabel — 클리어 버튼 레이블. HTML 사용 가능.
icons.trigger (기본값: "bi bi-clock") — 트리거 버튼 아이콘 클래스.
okLabel — 확인 버튼 레이블. HTML 사용 가능.
cancelLabel — 취소 버튼 레이블. HTML 사용 가능.

공개 API 메서드

// 현재 시간을 구조화된 객체로 반환

const data = $("#meetingStart").bsTimepicker("getTime");

// 반환: { hour24, minute, hour12, meridiem, formatted24, formatted12, isEmpty }

// 저장된 값을 "HH:mm" 문자열로 반환 (값 없으면 null)

const val = $("#meetingStart").bsTimepicker("val");

// 값 설정 (변경 이벤트 미발생)

$("#meetingStart").bsTimepicker("val", "16:45");

// 값 설정 (변경 이벤트 발생)

$("#meetingStart").bsTimepicker("setTime", "11:00");

// 값 초기화 (변경 이벤트 발생)

$("#meetingStart").bsTimepicker("clear");

// 드롭다운 열기 / 닫기 / 토글

$("#meetingStart").bsTimepicker("show");

$("#meetingStart").bsTimepicker("hide");

$("#meetingStart").bsTimepicker("toggle");

// 플러그인 제거 및 생성된 DOM 정리

$("#meetingStart").bsTimepicker("destroy");

4. 기타 참고 사항

원본 사이트에서 다운로드 받은 파일은 vendor 가 누락되어서 정상 작동하지 않습니다.
수정된 버젼을 첨부해 두었으니 소스다운로드 버튼을 클릭하여 다운로드 받아주세요.
demo/index2.html 파일을 실행하시거나 확인하시기 바랍니다.

[해피CGI][cgimall] jQuery 360도 상품 이미지 회전 뷰어 플러그인 Turntable.js

해피CGI윤실장 — Fri, 24 Jul 2026 09:34:36 +0900

# 라이센스

Turntable.js는 MIT 라이센스로 제공되는 jQuery 플러그인입니다.

MIT 라이센스는 비교적 자유로운 오픈소스 라이센스로, 라이센스 고지 조건을 준수하면 개인 프로젝트, 상업용 프로젝트, 웹사이트 제작, 쇼핑몰 상품 상세 페이지 등 다양한 용도로 활용할 수 있습니다.

단, 실제 프로젝트에 적용하기 전에는 배포 파일 또는 GitHub 저장소에 포함된 라이센스 파일을 함께 확인하는 것이 좋습니다.

공식 안내 기준 라이센스: MIT

출처: jQueryScript / GitHub PolarNotion Turntable.js

# 특징 및 설명

Turntable.js는 상품 이미지를 360도 회전하는 것처럼 보여주기 위한 jQuery 기반 이미지 로테이터 플러그인입니다.

일반적인 3D 모델링 방식이 아니라, 여러 각도에서 촬영한 이미지들을 순서대로 배치한 뒤 사용자의 마우스 움직임 또는 손가락 터치 움직임에 따라 이미지를 바꿔 보여주는 방식입니다.

예를 들어 상품을 10도 또는 15도 간격으로 여러 장 촬영해 두면, 사용자가 좌우로 드래그하거나 마우스를 움직일 때 이미지가 순차적으로 전환되면서 상품이 회전하는 것처럼 보입니다.

반응형 이미지 구성이 가능하며, 이미지의 가로 폭을 100%로 설정하여 컨테이너 크기에 맞게 출력할 수 있습니다.

마우스 이동 방향에 따라 이미지를 전환할 수 있으며, 기본적으로 x축 방향 움직임을 기준으로 작동합니다.

설정에 따라 y축 방향 또는 스크롤 기반 전환도 사용할 수 있습니다.

이미지 순서를 반대로 재생하는 reverse 옵션도 지원합니다.

상품 상세페이지, 제품 소개 페이지, 포트폴리오, 피규어·가구·전자제품·의류·기계 부품 등 여러 각도에서 보여줘야 하는 콘텐츠에 적합합니다.

브라우저 지원 안내에는 Chrome, IE9+, Firefox, Opera, Safari가 포함되어 있습니다.

주의할 점은 이 플러그인이 실제 3D 렌더링을 하는 것이 아니라 여러 장의 이미지를 빠르게 전환하는 방식이라는 점입니다. 따라서 자연스러운 360도 효과를 내려면 상품을 일정한 각도와 동일한 조명, 동일한 배경에서 촬영한 이미지 세트가 필요합니다.

# 사용 방법 & 설치 방법

1. 필요한 CSS/JS 파일을 설치하고 포함시키세요.

브라우저 우선 설정을 하려면 컴파일된 파일을 다운로드하고 IIFE 스크립트 앞에 CSS를 포함시키세요.

Turntable v2는 jQuery를 필요로 하지 않습니다.

2. npm 프로젝트의 경우, scoped 패키지를 설치하고 클래스와 스타일시트를 가져오세요.

npm install @goboldlyforward/turntable

import { Turntable } from "@goboldlyforward/turntable";

import "@goboldlyforward/turntable/css";

3. 직접적인 자식 요소를 가진 컨테이너를 생성합니다 .
각 프레임은 값을 가진 ul직접적인 요소를 사용합니다 .
Turntable은 이러한 요소를 자동으로 생성해 줍니다. 또한 값을 읽어 DOM 속성을 통해 각 URL을 할당합니다.

<ul>

</ul>

</div>

4. 턴테이블을 초기화하여 포인터 기반 360도 이미지 뷰어를 생성합니다.

const cameraViewer = new Turntable("#cameraSpin", {

axis: "x"

});

5. 사용 가능한 모든 구성 옵션.

- axis( "x" | "y" | "scroll"): 프레임 선택의 입력 방향을 설정합니다. "x"수평 포인터 이동, "y"수직 포인터 이동 또는 "scroll"뷰포트 기반 프레임 변경에 사용합니다.

- reverse( boolean): 상호 작용 중 프레임 순서를 반전시킵니다. 소스 이미지가 원하는 UI 동작과 반대 방향으로 회전하는 경우에 사용하십시오.

- scrollStart( "top" | "middle" | "bottom"): 스크롤 기반 회전을 위한 뷰포트 앵커를 설정합니다. 이 옵션은 axis를 사용하는 경우에만 적용됩니다 "scroll".

- autorotate( false | number): 초기화 시 자동 프레임 순환을 시작합니다. 프레임당 밀리초를 설정할 숫자를 전달하세요.

- controller( HTMLInputElement | null): 범위 입력을 뷰어에 연결합니다. 사용자가 범위를 변경하면 프레임이 설정되고, 뷰어의 프레임이 변경되면 범위 값이 업데이트 됩니다.

6. API 메서드.

// Jump to a specific frame index.

// The class clamps the value to the available frame range.

viewer.setFrame(3);

// Start automatic frame cycling.

// Pass a number to override the configured interval.

viewer.start(200);

// Stop automatic frame cycling.

viewer.stop();

// Recalculate frame sections.

// Call this after layout changes or after a hidden container becomes visible.

viewer.update();

// Remove listeners, observers, timers, and the active frame class.

viewer.destroy();

# 참고사항

- Turntable.js는 비교적 오래전에 공개된 플러그인이므로 최신 프론트엔드 환경에서는 직접 테스트 후 적용하는 것이 좋습니다.

- 특히 모바일 터치, 최신 jQuery 버전, 반응형 레이아웃, 이미지 지연 로딩, CDN 환경 등에서는 실제 운영 페이지에서 정상 작동 여부를 반드시 확인하는 것이 좋습니다.

- 파일 크기 안내 기준으로 jQueryScript 페이지에는 2.59MB로 표시되어 있습니다. 실제 적용 시에는 예제 이미지나 데모 파일까지 포함된 용량일 수 있으므로, 운영 사이트에는 필요한 JS, CSS, 이미지 파일만 선별해서 업로드하는 것이 좋습니다.

- 이 플러그인은 360도 회전 효과 자체보다 이미지 품질과 촬영 방식이 더 중요합니다. 상품을 일정한 간격으로 촬영하지 않으면 회전이 부자연스럽게 보일 수 있습니다.

- 쇼핑몰 상품 상세페이지에 적용할 경우, 최소 12장 이상 이미지를 준비하는 것이 좋고, 더 부드러운 회전을 원한다면 24장, 36장 이상의 이미지 세트를 사용하는 것이 좋습니다.

- 이미지 수가 많아질수록 로딩 속도에 영향을 줄 수 있으므로, 이미지 용량 최적화가 필요합니다.

- WebP 형식 사용, 썸네일 압축, lazy loading 적용, CDN 사용 등을 함께 고려하면 사용자 체감 속도를 개선할 수 있습니다.

- 적용 추천 분야는 쇼핑몰 상품 상세페이지, 제품 소개 페이지, 기계 장비 소개, 가구·인테리어 제품 소개, 피규어·소품 소개, 자동차·부품 소개, 전시품 소개 페이지 등입니다.