AgentSkillsCN

managing-ssh

当用户自定义tmux快捷键、前缀键，或对会话管理、窗格记事本、tmux插件、tmux-resurrect、会话保存与恢复，以及tmux.conf配置等主题提出疑问时，本技能将为您提供专业指导。

SKILL.md
--- frontmatter
name: managing-ssh
description: |
  This skill should be used when the user encounters "SSH key invalid format",
  authentication failures, Tailscale VPN issues, "sudo SSH_AUTH_SOCK" problems,
  or asks about ssh-agent, authorized keys, mosh setup.

SSH 및 Tailscale 관리

SSH 키, ssh-agent, Tailscale VPN 관련 가이드입니다.

Known Issues

sudo에서 SSH_AUTH_SOCK 유실

  • •sudo 실행 시 환경변수가 초기화되어 SSH 키 인증 실패
  • •해결: sudo -E 또는 sudoers에서 SSH_AUTH_SOCK 유지 설정

재부팅 후 SSH 키 미로드

  • •launchd agent로 자동 로드 설정되어 있지만 실패할 수 있음
  • •수동 로드: ssh-add ~/.ssh/id_ed25519

빠른 참조

SSH 키 상태 확인

bash
# 로드된 키 확인
ssh-add -l

# 키 로드
ssh-add ~/.ssh/id_ed25519

# 키 언로드
ssh-add -d ~/.ssh/id_ed25519

Tailscale 상태

bash
# 연결 상태 확인
tailscale status

# 재인증 (만료 시)
tailscale up

# IP 확인
tailscale ip -4

SSH 설정 파일

파일용도
~/.ssh/configSSH 호스트 설정
~/.ssh/id_ed25519개인 키
~/.ssh/id_ed25519.pub공개 키
~/.ssh/authorized_keys인증된 키 (서버)

authorizedKeys 추가 (NixOS)

nix
# hosts/<hostname>/default.nix
users.users.<username>.openssh.authorizedKeys.keys = [
  "ssh-ed25519 AAAA... user@host"
];

자주 발생하는 문제

  1. •SSH 키 invalid format: 키 파일 끝에 개행 문자 필요
  2. •GitHub SSH 접근 실패: ssh-add -l로 키 로드 확인
  3. •Tailscale 만료: tailscale up으로 재인증
  4. •sudo 인증 실패: sudo -E 또는 SSH_AUTH_SOCK 유지

레퍼런스