<div id="readability-page-1" class="page"><div>
<article>
<header>


</header>

<p><a href="/ko/article/how-to-install-wsl2-and-use-linux-on-windows-10/">WSL</a>을 사용하면 윈도우에서 별도의 <a href="/ko/article/virtual-machine/">가상머신</a> 생성 없이도 <a href="/ko/article/linux/">리눅스</a>를 활용할 수 있습니다. WSL에서 사용하는 리눅스 환경은 일반적인 리눅스와는 약간의 차이가 있습니다만, 설정을 조금 더하면 리눅스답게 사용할 수 있습니다. 특히 리눅스 서버는 SSH 프로토콜로 원격에서 접속해서 커맨드라인 작업을 하는 게 일반적입니다. WSL 리눅스 역시 <a href="/ko/article/openssh/">OpenSSH</a> 서버를 설치하고, 원격에서 SSH로 접속하는 것이 가능합니다. 또한 systemd를 활성화해서 SSH를 서비스로 관리할 수 있습니다. 이 글에서는 WSL 리눅스에서 OpenSSH 서버를 활성화하고 서비스로 등록하는 방법을 소개합니다.</p>
<p><em>주의: 이 글에서 소개하는 방법은 WSL이 고정 IP를 제공하지 않기 때문에 IP가 변경되면 동작하지 않습니다. 여기서는 OpenSSH 서버를 설정하고 포트포워딩과 방화벽을 설정하는 방법까지만 소개합니다. 이 문제를 해결하는 자료들도 함께 소개하니 참고해주세요.</em></p>
<nav>
<ul>
<li><a href="#wsl%EC%97%90%EC%84%9C-openssh-%EC%84%A4%EC%B9%98%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">WSL에서 OpenSSH 설치하는 방법</a></li>
<li><a href="#wsl%EC%97%90%EC%84%9C-systemd-%ED%99%9C%EC%84%B1%ED%99%94">WSL에서 systemd 활성화</a></li>
<li><a href="#%EC%9C%88%EB%8F%84%EC%9A%B0%EC%97%90%EC%84%9C-%EC%A0%91%EC%86%8D-%ED%85%8C%EC%8A%A4%ED%8A%B8">윈도우에서 접속 테스트</a></li>
<li><a href="#%EB%A1%9C%EC%BB%AC-%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC%EC%97%90%EC%84%9C-%EC%A0%91%EC%86%8D-%EA%B0%80%EB%8A%A5%ED%95%98%EB%8F%84%EB%A1%9D-%ED%8F%AC%ED%8A%B8%ED%8F%AC%EC%9B%8C%EB%94%A9-%EC%84%A4%EC%A0%95">로컬 네트워크에서 접속 가능하도록 포트포워딩 설정</a></li>
<li><a href="#wsl-%EB%A8%B8%EC%8B%A0-ip-%EB%B3%80%EA%B2%BD%EC%97%90-%EB%94%B0%EB%A5%B8-%ED%95%9C%EA%B3%84%EC%A0%90">WSL 머신 IP 변경에 따른 한계점</a></li>
<li><a href="#%EB%B6%80%EB%A1%9D-%ED%8F%AC%ED%8A%B8%ED%8F%AC%EC%9B%8C%EB%94%A9-%EB%B0%8F-%EB%B0%A9%ED%99%94%EB%B2%BD-%EC%84%A4%EC%A0%95-%EC%82%AD%EC%A0%9C%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">부록: 포트포워딩 및 방화벽 설정 삭제하는 방법</a></li>
<li><a href="#%EC%B0%B8%EA%B3%A0-%EB%AC%B8%EC%84%9C">참고 문서</a></li>
</ul>
</nav>
<h2 id="wsl에서-openssh-설치하는-방법">WSL에서 OpenSSH 설치하는 방법</h2>
<p>이 글에서는 WSL이 설치 되어있다고 가정합니다. 아직 WSL을 사용하고 있지 않다면 다음 글을 참고해서 WSL을 설치해주세요.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-install-wsl2-and-use-linux-on-windows-10/"><windows> WSL2 설치 및 사용법</windows></a>
</li>
</ul>
<p>리눅스 배포판은 선호하는 것을 사용해도 무방합니다. 이 글에서는 <a href="/ko/article/ubuntu/">우분투</a> 배포판을 예제로 진행합니다. 윈도우 터미널에서 파워셸을 실행하고 다음 명령어를 실행해 Ubuntu 배포판(혹은 자신이 사용하는 WSL 리눅스 배포판 이름으로) 셸을 실행합니다. 여기서는 WSL 배포판 이름을 Ubuntu라고 가정합니다.</p>
<pre><code>$ wsl -d Ubuntu</code></pre>
<p>다음 명령어를 실행해 OpenSSH 서버를 설치합니다. ssh는 openssh-server 패키지와 같습니다.</p>
<pre><code>$ apt update
$ apt install ssh</code></pre>
<p>이걸로 SSH 서버 설치는 마쳤습니다. 하지만 아직 추가적인 작업들이 필요합니다. 한 단계씩 따라와주세요.</p>
<h2 id="wsl에서-systemd-활성화">WSL에서 systemd 활성화</h2>
<p>openssh-server 패키지를 설치하면 자동으로 서비스로 등록합니다. 이를 확인하기 위해서 <code>systemctl</code> 명령어로 SSH 상태를 확인해봅니다.</p>
<pre><code>$ sudo systemctl status ssh
System has not been booted with systemd as init system (PID 1). Can't operate.
Failed to connect to bus: Host is down</code></pre>
<p>리눅스의 서비스를 관리하는 systemd가 활성화되어있지 않다면, 위와 같이 에러가 출력될 것입니다. 먼저 systemd를 활성화해보겠습니다. <code>/etc/wsl.conf</code> 파일이 존재하는지 확인해봅니다. 파일이 없다면 새로 만들어주세요.</p>
<pre><code>[boot]
systemd=true</code></pre>
<p>이미 파일이 있다면 위 내용을 참고해서 <code>[boot]</code> 섹션에 <code>systemd=true</code>를 추가해주세요. 이제 윈도우 파워셸로 돌아가서 다음 명령어로 WSL 머신을 종료하고 재실행합니다.</p>
<pre><code>$ wsl --terminate Ubuntu
$ wsl -d Ubuntu</code></pre>
<p>다시 systemctl로 SSH 서비스의 상태를 확인해봅니다. 아래와 같이 Active 값이 active (running)이면 성공입니다. 아래 로그 정보에서 확인할 수 있듯이 SSH 서버는 기본적으로 0.0.0.0:22로 실행됩니다.</p>
<pre><code>$ sudo systemctl status ssh
[sudo] password for lainyzine:
● ssh.service - OpenBSD Secure Shell server
Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2023-07-06 04:18:43 KST; 6min ago
Docs: man:sshd(8)
man:sshd_config(5)
Process: 177 ExecStartPre=/usr/sbin/sshd -t (code=exited, status=0/SUCCESS)
Main PID: 232 (sshd)
Tasks: 1 (limit: 38507)
Memory: 6.3M
CGroup: /system.slice/ssh.service
└─232 "sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups"

Jul 06 04:18:43 DESKTOP-21LTHRR systemd[1]: Starting OpenBSD Secure Shell server...
Jul 06 04:18:43 DESKTOP-21LTHRR sshd[232]: Server listening on 0.0.0.0 port 22.
Jul 06 04:18:43 DESKTOP-21LTHRR sshd[232]: Server listening on :: port 22.
Jul 06 04:18:43 DESKTOP-21LTHRR systemd[1]: Started OpenBSD Secure Shell server.</code></pre>
<p>SSH 서버는 떴지만, 아직입니다. 다음으로 네트워크 관련 작업이 필요합니다.</p>
<h2 id="윈도우에서-접속-테스트">윈도우에서 접속 테스트</h2>
<p>WSL 머신 셸에서 <code>ifconfig</code>로 eth0 인터페이스의 IP(로컬 네트워크 상의 WSL 머신 IP)를 확인해보겠습니다.</p>
<pre><code>$ ifconfig
(...)
eth0: flags=4163&lt;UP,BROADCAST,RUNNING,MULTICAST&gt;  mtu 1280
inet 172.30.106.8  netmask 255.255.240.0  broadcast 172.30.111.255
ether 00:99:88:40:66:3c  txqueuelen 1000  (Ethernet)
RX packets 4  bytes 868 (868.0 B)
RX errors 0  dropped 0  overruns 0  frame 0
TX packets 11  bytes 894 (894.0 B)
TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
(...)</code></pre>
<p>여기서 172.30.106.8이 WSL 머신의 IP가 됩니다. 172.30.106.8이 포함된 172.16.0.0/20 IP 대역은 Private IP 대역 중 하나입니다. WSL에서는 이 IP 범위 중 일부를 사용합니다. 이 IP는 윈도우 호스트 머신 내부에서만 접근할 수 있습니다. 윈도우에서는 <code>wsl</code> 명령어로 셸을 바로 실행할 수 있어서 SSH로 접속할 필요는 없습니다만, 어디까지나 테스트로 윈도우에서 SSH로 접속해보겠습니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-connect-to-linux-server-with-ssh-on-windows-10/">&lt;Windows 10&gt; SSH로 리눅스 서버에 접속하는 방법</a>
</li>
</ul>
<p>윈도우 파워셸에서 다음 명령어로 SSH 클라이언트를 설치합니다. 이미 설치되어있다면 생략해도 무방합니다.</p>
<pre><code>$ Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0</code></pre>
<p>다음으로 <code>ssh</code> 명령어로 WSL 머신에 접속해봅니다.</p>
<pre><code>$ ssh lainyzine@172.30.106.8 -p 22</code></pre>
<p>여기서 lainyzine은 자신이 사용하는 WSL 사용자 이름으로 변경해주세요. 172.30.106.8도 직접 확인한 WSL 머신 IP로 변경합니다. 22는 SSH 기본 포트입니다. 명령어를 실행하고 뭔가 반응이 있다면 정상 동작하는 것입니다. 처음 접속하는 서버이므로 먼저 호스트 확인을 하고, 패스워드 입력으로 넘어갑니다. 패스워드를 입력해서 SSH로 로그인까지 해봅니다.</p>
<p>접속에 성공했다면 WSL 머신에서 SSH 서버가 정상 동작중이라는 것을 확인할 수 있습니다.</p>
<p>그렇다면 로컬 네트워크에서도 이 IP로 WSL의 SSH 서버에 접속할 수 있을까요? 로컬 네트워크 상의 다른 머신을 하나 준비하고 바로 테스트해봅니다.</p>
<pre><code>$ ssh lainyzine@172.30.106.8 -p 22</code></pre>
<p>하지만 앞서 소개한대로, 이 IP는 윈도우 호스트 머신 내부에서만 유효하기 때문에 아무런 반응이 없을 것입니다. 반응이 없다면 ^c(Ctrl + C)를 눌러서 종료합니다. 다음 절에서는 로컬 네트워크에서 이 WSL SSH 서버에 접속 가능하도록 호스트 머신에 추가 설정하는 방법을 소개합니다.</p>
<div>
<p>
가상 스위치를 사용해 브릿지 모드 사용하기
</p>
<div>

<p>다음 절에서는 윈도우 호스트에서 WSL로 포트포워딩을 하고 윈도우에서 방화벽을 열어 WSL SSH 서버에 접속하는 방법을 소개합니다. 하지만 WSL의 기본 네트워크의 경우 윈도우 호스팅 머신 재부팅 시에 IP 주소가 변경될 수 있기 때문에 로컬 네트워크에서 SSH 서버나 개발 서버로 사용하기는 애로사항이 있습니다.</p>
<p>이를 해결하기 위한 방법 중에 하나가 Hyper-V의 가상 스위치를 사용해서 WSL의 네트워크 모드를 브릿지 모드로 사용하는 방법입니다. 이렇게 설정하면 WSL의 IP가 172.30.x.x가 아닌 로컬 네트워크의 DHCP 서버에서 직접 할당 받을 수 있습니다. 그리고 로컬 네트워크에서는 이 IP로 직접 접근하는 게 가능합니다.</p>
<p>즉, 로컬 네트워크에서 WSL 리눅스와 윈도우 호스트가 같은 수준의 기기로 인지 됩니다. 가상 스위치와 WSL 브릿지 모드 설정 방법은 다음 글에서 소개합니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/fix-wsl2-ip-by-virtual-switch/">WSL2에서 아이피 고정하는 방법(가상 스위치)</a></li>
</ul>
<p>브릿지 모드를 사용하는 경우 아래에서 소개하는 추가 네트워크 설정(포트포워딩 및 방화벽) 설정을 사용하지 않습니다.</p>

</div>
</div>
<h2 id="로컬-네트워크에서-접속-가능하도록-포트포워딩-설정">로컬 네트워크에서 접속 가능하도록 포트포워딩 설정</h2>
<p>앞에서 테스트해본 것처럼 172.30.x.x IP는 호스트 윈도우 머신에서만 유효하며, 로컬 네트워크에서는 접근할 수 없습니다. 따라서 호스트 윈도우 PC가 있는 로컬 네트워크에서 WSL 머신의 SSH 서버에 접속할 수 있도록 추가 설정이 필요합니다.</p>
<p>원리는 이렇습니다. 로컬 네트워크에서는 윈도우 호스트 PC에 접속할 수 있습니다. 그리고 윈도우 호스트 PC에서는 WSL의 SSH에 접속할 수 있습니다. 예를 들어 윈도우 호스트의 IP가 192.168.1.107이라면, 192.168.1.107의 2022 포트로 요청이 들어오면, 172.30.106.8:22로 포워딩되도록, 포트 포워딩을 설정합니다. 그리고 호스트 머신의 2022 포트에 대해서 방화벽을 허용해줍니다.</p>
<p>다시 호스트 윈도우 파워셸로 돌아가겠습니다. 윈도우 터미널을 관리자 모드로 실행하고, 파워셸을 실행합니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-run-windows-terminal-and-powershell-in-administrator-mode/">윈도우 터미널 앱 관리자 모드로 실행하는 방법</a>
</li>
</ul>
<p>먼저 <code>ipconfig</code>로 윈도우 머신의 IP를 확인해주세요. 사용중인 이더넷 어댑터의 IPv4 주소를 확인하면됩니다. 일반적으로 <code>192.168.0.x</code> 혹은 <code>192.168.1.x</code>와 같은 주소를 확인할 수 있습니다. 혹은 제어판 -&gt; 네트워크 -&gt; 사용중인 이더넷 인터페이스 선택 -&gt; 추가 속성 보기 에서 IPv4 주소를 확인할 수도 있습니다. 여기서는 이 주소가 192.168.1.107이라고 가정하겠습니다.</p>
<p>다음 명령어를 실행해 포트포워딩 규칙을 생성합니다.</p>
<pre><code>$ netsh interface portproxy add v4tov4 listenaddress=192.168.1.107 listenport=2022 connectaddress=172.30.106.8 connectport=22</code></pre>
<p><code>listenaddress</code>에는 윈도우 호스트의 ip를 입력합니다. <code>listenport</code>는 윈도우 호스트로 연결할 포트입니다. <code>connectedaddress</code>는 WSL 리눅스의 IP를 입력합니다. <code>connectport</code>는 WSL 머신에서 연결할 포트입니다.</p>
<p>다음 명령어로 추가한 포트포워딩 규칙을 확인해봅니다.</p>
<pre><code>$ netsh interface portproxy show v4tov4

ipv4 수신 대기:             ipv4에 연결:

주소            포트        주소            포트
--------------- ----------  --------------- ----------
192.168.1.107   2022        172.30.106.8    22</code></pre>
<p>테스트를 위해 로컬 네트워크 상의 SSH 클라이언트를 가진 다른 머신이 필요합니다. 다음 명령어로 WSL 머신의 SSH에 접속 가능한지 테스트해봅니다.</p>
<pre><code>$ ssh lainyzine@192.168.1.107 -p 2022</code></pre>
<p>아마 방화벽에 막혀서 접속이 되지 않을 것입니다. 접속이 되지 않는다면 관리자 모드로 실행된 윈도우 파워셸에서 아래 명령어를 실행해 방화벽 규칙을 추가해줍니다.</p>
<pre><code>$ New-NetFireWallRule -DisplayName 'WSL Ubuntu SSH 2022 Open' -Direction Outbound -LocalPort 2022 -Action Allow -Protocol TCP
$ New-NetFireWallRule -DisplayName 'WSL Ubuntu SSH 2022 Open' -Direction Inbound -LocalPort 2022 -Action Allow -Protocol TCP</code></pre>
<p>다음 명령어로 새로 추가한 방화벽 규칙을 확인해봅니다.</p>
<pre><code>$ Get-NetFirewallRule -DisplayName 'WSL Ubuntu SSH 2022 Open' | Get-NetFirewallPortFilter | Format-Table

Protocol LocalPort RemotePort IcmpType DynamicTarget
-------- --------- ---------- -------- -------------
TCP      2022      Any        Any      Any
TCP      2022      Any        Any      Any</code></pre>
<p>다시 로컬 네트워크 상의 다른 머신에서 SSH로 접속해보면 성공적으로 접속 되는 것을 확인할 수 있습니다.</p>
<pre><code>$ ssh lainyzine@192.168.1.107 -p 2022
lainyzine@192.168.1.107's password:
Welcome to Ubuntu 22.04.1 LTS (GNU/Linux 5.15.90.1-microsoft-standard-WSL2 x86_64)

* Documentation:  https://help.ubuntu.com
* Management:     https://landscape.canonical.com
* Support:        https://ubuntu.com/advantage

* Strictly confined Kubernetes makes edge and IoT secure. Learn how MicroK8s
  just raised the bar for easy, resilient and secure K8s cluster deployment.

  https://ubuntu.com/engage/secure-kubernetes-at-the-edge
  Last login: Thu Jul  6 04:59:36 2023

$ </code></pre>
<p>여기까지 WSL 머신에 SSH 서버를 활성화하고, 로컬 네트워크 접속하는 방법을 알아보았습니다.</p>
<h2 id="wsl-머신-ip-변경에-따른-한계점">WSL 머신 IP 변경에 따른 한계점</h2>
<p>하지만 앞서 언급했듯이 이 글에서 소개하는 방법에는 한계가 있습니다. WSL의 IP가 수시로 변경될 수 있기 때문에, SSH 서버를 안정적으로 지속적으로 사용하려면 먼저 이 문제를 해결하는 방법을 찾아야합니다. 현재로서는 <a href="https://github.com/ocroz/wsl2-boot/tree/master">wsl2-boot로 IP를 고정하거나</a>, <a href="https://medium.com/geekculture/enable-ssh-access-into-wsl-from-a-remote-computer-f2e4a962430">윈도우 부팅시 방화벽 규칙을 새로 적용하는 스크립트를 실행하거나</a>, 가상 스위치로 WSL을 브릿지 모드로 사용하는 방법 등이 있습니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/fix-wsl2-ip-by-virtual-switch/">WSL2에서 아이피 고정하는 방법(가상 스위치)</a>
</li>
</ul>
<p>어느 방법이 가장 좋다고는 할 수 없습니다. 개인적으로는 Hyper-V의 가상 스위치를 사용하는 방법을 선호합니다만, 이 방법은 윈도우 홈 에디션에서는 적용할 수 없고, Hyper-V에 의한 그래픽 카드 성능 저하가 발생할 수 있습니다. 본인의 상황에 맞는 방법을 적용해주세요.</p>
<h2 id="부록-포트포워딩-및-방화벽-설정-삭제하는-방법">부록: 포트포워딩 및 방화벽 설정 삭제하는 방법</h2>
<p>앞서 적용한 포트포워딩 및 방화벽 설정을 삭제하는 명령어입니다. 파워셸을 관리자 모드로 열고, 다음 명령어들을 실행해주세요.</p>
<pre><code>$ netsh interface portproxy delete v4tov4 listenaddress=192.168.1.107 listenport=2022 
$ Remove-NetFirewallRule -DisplayName 'WSL Ubuntu SSH 2022 Open'</code></pre>
<p>현재 등록된 포트 포워딩 상태를 확인할 수 있습니다.</p>
<pre><code>$ netsh interface portproxy show v4tov4</code></pre>
<p>특정 방화벽 규칙의 상태는 다음 명령어로 확인할 수 있습니다.</p>
<pre><code>$ Get-NetFirewallRule -DisplayName 'WSL Ubuntu SSH 2022 Open' | Get-NetFirewallPortFilter | Format-Table</code></pre>
<h2 id="참고-문서">참고 문서</h2>
<p>이 글에서는 WSL 리눅스 머신에서 OpenSSH 서버를 실행하는 방법을 소개했습니다. WSL이 아닌 윈도우 호스트 머신에서도 SSH를 활성화할 수 있습니다. 윈도우에서 OpenSSH를 활성화하는 방법에 대해서는 다음 글에서 소개합니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/how-to-run-openssh-server-and-connect-with-ssh-on-windows-10/"><windows> OpenSSH 서버 실행하고 SSH로 접속하는 방법</windows></a></li>
</ul>

</article>
</div></div>

LZ: 프로그래머 가이드

LainyZine

윈도우에서 리눅스를 사용할 수 있는 WSL에도 SSH 서버를 설치하고 원격에서 접속할 수 있습니다. 이 글에서는 WSL 리눅스에 SSH 서버를 설치하고 로컬 네트워크에서 접속하는 방법을 소개합니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

WSL 리눅스에서 SSH 서버 자동 실행하는 법

댓글