plzhans (손원철) @plzhans

개발하며 구축한 것들의 트러블슈팅 기록을 남기는 블로그입니다.

GitHub LinkedIn code mail rss

Categories
Tags

전체 글

Tailscale Linux 설치 - 안전한 원격 VPN 구성
Tailscale Linux 설치 - 안전한 원격 VPN 구성 리눅스 서버에 Tailscale을 설치해 안전한 원격 VPN 환경을 구성하는 방법을 설명합니다. 아웃바운드 기반 연결, P2P 통신, DERP 릴레이, Serve와 Funnel 활용 방식을 함께 정리합니다.
Networking 2026-07-03
OpenClaw 노드 모드 설치와 원격 인프라 연결 방법
OpenClaw 노드 모드 설치와 원격 인프라 연결 방법 OpenClaw 노드 모드로 원격 서버를 게이트웨이에 연결하는 방법을 설명합니다. 설치, 실행 확인, 장치 승인, systemd 서비스 등록까지 인프라 제어 흐름을 정리합니다.
AI 2026-06-29
Samsung SmartThings API 연동 방법 - CLI 설치부터 OAuth 인증까지
Samsung SmartThings API 연동 방법 - CLI 설치부터 OAuth 인증까지 Samsung SmartThings API 연동에 필요한 CLI 설치, OAuth 앱 생성, Redirect URI 설정, 토큰 발급, 디바이스 조회 방법을 단계별로 정리합니다.
Etc 2026-06-29
Mac Office 정품인증 방법 | 볼륨 라이선스 VL Serializer로 LTSC 설치
Mac Office 정품인증 방법 | 볼륨 라이선스 VL Serializer로 LTSC 설치 Mac에서 Microsoft Office를 볼륨 라이선스로 설치하고 정품 인증을 활성화하는 절차를 정리한다. LTSC 설치 파일 선택부터 VL Serializer 적용과 인증 확인 방법까지 한 번에 안내한다.
Etc 2026-06-17
Synology DSM 무료 SSL 인증서 발급 방법 | acme.sh + Cloudflare DNS로 Let’s Encrypt 자동 갱신
Synology DSM 무료 SSL 인증서 발급 방법 | acme.sh + Cloudflare DNS로 Let’s Encrypt 자동 갱신 Synology DSM에서 acme.sh와 Cloudflare DNS 인증으로 Let’s Encrypt 무료 SSL 인증서를 발급하고 자동 갱신하는 방법을 정리한다. synology_dsm deploy-hook 설정과 2FA 및 Hostname 오류 해결까지 안내한다.
Etc 2026-05-16
Terraform 실무 가이드: 설치, plan/apply, AWS SSO·AssumeRole, state backend
Terraform 실무 가이드: 설치, plan/apply, AWS SSO·AssumeRole, state backend Terraform 설치부터 init·plan·apply 기본 흐름과 프로젝트 구조를 정리한다. AWS 자격증명에서 SSO와 AssumeRole 차이, state 공유를 위한 backend 개념과 AWS(S3) 예시, 최소 IAM 권한과 운영 팁까지 한 번에 확인한다.
Devops 2026-05-06
age 사용법 정리: recipients로 팀 비밀 파일 암호화하고 개인키로 복호화
age 사용법 정리: recipients로 팀 비밀 파일 암호화하고 개인키로 복호화 age로 팀 비밀 파일을 공개키(recipients)로 암호화하고 개인키로 복호화하는 방법을 정리한다. 키 생성, recipients 관리, GPG와 차이점, 구성원 변경 시 재암호화가 필요한 이유까지 함께 설명한다.
Security 2026-05-01
Claude 계정 스위치 자동화
Claude 계정 스위치 자동화 Claude Code 계정을 로그아웃 없이 빠르게 전환하는 방법을 정리합니다. macOS Keychain의 인증 정보를 security 명령으로 백업·교체하는 자동화 스크립트와 claudini·CCSwitcher 같은 전용 도구 사용법을 함께 다룹니다.
AI 2026-03-26
네이버 지도 Open API 인증 실패(200) 해결: ncpClientId에서 ncpKeyId로 변경
네이버 지도 Open API 인증 실패(200) 해결: ncpClientId에서 ncpKeyId로 변경 네이버 지도 Open API에서 Authentication Failed(200) 오류가 나는 원인을 정리합니다. 콘솔 통합으로 ncpClientId·govClientId·finClientId가 ncpKeyId로 바뀜 점과, 포트·URI를 제외해야 하는 웹 서비스 URL 등록 규칙까지 확인하세요.
Cloud 2026-03-24
wg-easy WireGuard MASQUERADE 예외 설정으로 OpenVPN 클라이언트 IP 유지하기
wg-easy WireGuard MASQUERADE 예외 설정으로 OpenVPN 클라이언트 IP 유지하기 wg-easy WireGuard에서 MASQUERADE 때문에 요청 IP가 VPN 서버로 바뀌는 원인과 해결책을 정리합니다. iptables NAT 규칙에서 특정 목적지 대역을 제외해 OpenVPN 클라이언트 사설 IP를 그대로 로그에 남깁니다.
Networking 2026-03-19
Amazon Linux 2023 ARM64 EC2에서 Docker와 Docker Compose 설치하기
Amazon Linux 2023 ARM64 EC2에서 Docker와 Docker Compose 설치하기 Amazon Linux 2023 ARM64(aarch64) EC2에서 dnf로 Docker를 설치하고 서비스 활성화와 docker 그룹 권한까지 구성하는 방법을 정리합니다. Docker Compose 플러그인 설치와 버전 고정, permission denied·arm64 manifest 오류 해결, 로그 용량 제한과 디스크 정리까지 함께 다룹니다.
Cloud 2026-03-19
오픈클로(OpenClaw) 구축
오픈클로(OpenClaw) 구축 OpenClaw(OpenClaw AI agent framework)를 로컬에서 설치하고 onboard로 모델·채널·스킬을 설정하는 과정을 정리했습니다. 텔레그램 봇 인증과 보안 경고 체크 포인트를 따라 하며 안전하게 에이전트를 실행하세요.
AI 2026-02-23
Windows/Linux/macOS DNS 캐시 지우기
Windows/Linux/macOS DNS 캐시 지우기 DNS 레코드 변경 후 접속이 안 될 때 Windows·Linux·macOS에서 DNS 캐시를 플러시하는 방법을 정리합니다. ipconfig, resolvectl, mDNSResponder 명령과 TTL·브라우저 캐시 확인으로 전파 지연을 빠르게 진단하세요.
Networking 2026-02-22
Git에서 GPG로 커밋 서명하기
Git에서 GPG로 커밋 서명하기 Git 커밋에 GPG 서명을 적용해 Verified 배지를 표시하는 방법을 정리했습니다. GnuPG 설치와 키 생성·내보내기부터 git commit 자동 서명 설정, 로컬 서명 검증, GitHub 공개키 등록과 오류 해결까지 한 번에 확인하세요.
Git 2026-02-16
GPG로 .env 파일 암호화해서 안전하게 커밋하기
GPG로 .env 파일 암호화해서 안전하게 커밋하기 .env 파일을 Git에 커밋해야 할 때 GPG로 암호화해 비밀값 노출을 막는 방법을 정리했습니다. .gitignore 처리부터 gpg encrypt/decrypt 명령과 recipient 기본 설정까지 적용해 안전한 저장소 운영을 시작하세요.
Git 2026-02-16
hugo site 다국어 지원하기
hugo site 다국어 지원하기 Hugo 다국어 블로그에서 baseURL, sitemap, robots, JSON-LD, Open Graph, meta description을 설정하고 hreflang·canonical로 중복 이슈를 막는 방법을 정리했습니다. slug·translationKey 트러블슈팅까지 한 번에 확인하세요.
Web 2026-02-11
Hugo + Github 블로그 만들기
Hugo + Github 블로그 만들기 Notion→Markdown→Hugo 빌드→GitHub Pages 배포 흐름으로 개인 블로그를 구축하는 과정을 정리했습니다. Hugo 설치와 m10c 테마 적용, GitHub Actions 자동 배포, baseURL 설정 주의점까지 따라 하며 배포 오류를 줄이세요.
Web 2026-02-10
Github pages 커스텀 도메인 사용하기
Github pages 커스텀 도메인 사용하기 GitHub Pages에 커스텀 도메인을 연결할 때 필요한 CNAME·A/AAAA 레코드 설정과 Pages의 Custom domain 적용 절차를 정리했습니다. Actions와 브랜치 배포의 CNAME 파일 처리 차이, dig로 DNS 확인, CAA 레코드 때문에 Enforce HTTPS가 안 켜지는 원인까지 다룹니다.
Web 2026-02-10
Redis dump vs aof
Redis dump vs aof Redis 퍼시스턴스에서 RDB(Dump), AOF, Hybrid AOF 차이와 redis.conf 핵심 설정을 비교 정리했습니다. BGSAVE·fsync·COW 영향과 선택 기준을 이해해 데이터 유실 위험과 재시작 시간을 균형 있게 최적화하세요.
Database 2026-02-06
HTTPS TLS/SSL 무료 vs 유료 인증서
HTTPS TLS/SSL 무료 vs 유료 인증서 HTTPS 구축 시 필요한 TLS/SSL 인증서 발급·검증 흐름과 무료(ACME/Let’s Encrypt)·유료·클라우드 관리형 옵션을 비교합니다. 갱신 자동화와 종단 지점 최소화 전략으로 비용과 운영 리스크를 줄이는 방법을 확인하세요.
Web 2026-02-06