해나래

[Electron] Error: listen EACCES: permission denied 0.0.0.0:3000

해구름 — Tue, 14 Apr 2026 22:15:28 +0900

오류설명

VisualStudio Code에서 F5 키를 통해 잘 디버깅해왔던 Electron 프로젝트가 어느날 갑자기 아래의 오류와 함께 실행이 안될 수 있습니다.

오류 : error during start dev server and electron app:
Error: listen EACCES: permission denied 0.0.0.0:3000

해결방법

Windows의 경우 무작위로 일부 포트 범위를 특정 서비스를 위해 예약해 두는데, VisualStudio Code로 디버깅을 실행할 때 디버거나 개발서버가 이미 예약된 포트로 연결하기 때문에 이러한 오류가 발생합니다. 이 오류의 해결방법은 아래와 같이 간단히 해결할 수 있습니다.

[명령 프롬프트]를 관리자 권한으로 실행합니다.
아래의 명령어를 순차적으로 입력합니다.
net stop winnat
net start winnat
위 명령을 실행하면 WinNAT가 재시작되면서 기존의 예약된 포트가 해제되고, 다시 무작위로 예약된 포트가 재설정 되면서 문제가 해결됩니다.

[WPF] Icon 설정

해구름 — Fri, 13 Feb 2026 14:05:22 +0900

WPF 프로젝트에서 ICON 설정하는 순서를 정리합니다.

Icon 이미지 생성

Icon으로 사용할 .png 이미지 생성합니다. 128x128 권장됩니다.
생성된 png 이미지로 .ico 이미지 생성합니다.
이미지들을 WPF 프로젝트에 추가합니다. 여기서는 /Assets/Images 폴더에 저장했습니다. Build Action은 모두 Resource로 지정합니다.

ApplicationIcon

빌드 후 생성되는 .exe 파일의 Icon을 말합니다. 설정하는 방법은 아래 3가지가 있으며, 하나를 선택하여 진행합니다.

(방법1) Visual Studio의 WPF 프로젝트 설정으로 이동합니다. → Application / Win32 Resources / Icon에서 ico 파일을 선택합니다.
(방법2) Visual Studio의 WPF 프로젝트 파일 (예: .csproj) 을 텍스트편집기로 열고, 아래와 같이 <ApplicationIcon>을 설정합니다.
```
<PropertyGroup>
    <ApplicationIcon>Assets\Images\Icon128.ico</ApplicationIcon>
    ...
</PropertyGroup>
```

(방법3) 앱의 시작 시 아래와 같은 C#코드를 실행하세요.

public MainWindow()
{
    InitializeComponent();
    Uri iconUri = new Uri("pack://application:,,,/Assets/Images/Icon128.ico", UriKind.RelativeOrAbsolute);
    this.Icon = BitmapFrame.Create(iconUri);
    ...
}

WindowIcon

Window의 좌측 상단 Title 부분에 표시될 Icon을 설정합니다.

<Window x:Class="wpfTest.MainWindow"
    Icon="Assets/Images/Icon128.ico">
    ...
</Window>

PackageIcon

Nuget Package로 빌드할 때 사용할 아이콘을 설정합니다. Nuget Package로 배포할 경우 사용합니다.

Visual Studio에서 WPF 프로젝트의 설정으로 이동합니다.
Package / General로 이동한 후 Icon을 설정합니다. 128x128 크기의 .png, .jpeg 확장자 이미지가 권장됩니다.

[WPF] ComboBox 항목 가상화

해구름 — Fri, 6 Feb 2026 10:21:06 +0900

WPF에서 ComboBox를 사용할 때 ItemsSource에 너무 많은 리스트를 바인딩하면 ComboBox가 느려지는 문제가 있습니다. 대략 1천개의 항목만 바인딩해도 2-3초간 버벅이게 됩니다.

이 문제는 ComboBox가 ItemsSource에 지정된 모든 리스트를 한번에 렌더링하려고 하기 때문에 발생하는 문제입니다. 화면에 보여지는 일부 항목만 렌더링하면 속도가 개선될텐데, WPF는 그렇게 하지 않는 것이죠.

다행이도 WPF는 이러한 문제를 해결하기 위해 VirtualizingStackPanel이라는 클래스를 제공합니다. ListView, DataGrid는 ItemsSource에 수만개의 리스트를 바인딩해도 아무런 문제가 없는데요. 바로 VirtualizingStackPanel를 내부적으로 사용하고 있기 때문입니다. VirtualizingStackPanel는 화면에 보여지는일부 항목만 렌더링하기 때문에 속도가 개선되는 것이지요.

ComboBox는 VirtualizingStackPanel를 사용하지 않기 때문에, 직접 VirtualizingStackPanel를 사용하도록 구현해주어야 합니다. 아래의 순서로 진행해주세요.

VisualStudio에서 Class를 추가하고, 이름은 적당히 ComboBoxVirtualizing.cs로 해요.

아래와 같이 VirtualizingStackPane을 ItemPanel로 지정해주세요.

using System;
using System.Windows;
using System.Windows.Controls;

namespace TestProject.Controls
{
	public class ComboBoxVirtualizing : ComboBox
	{
		public ComboBoxVirtualizing() : base()
		{
			var itemsPanelTemplate = new ItemsPanelTemplate();
			itemsPanelTemplate.VisualTree = new FrameworkElementFactory(typeof(VirtualizingStackPanel));
			ItemsPanel = itemsPanelTemplate;
		}
	}
}

이제 위에서 생성한 ComboBoxVirtualizing을 테스트해 봅시다. xaml에 다음과 같이 추가합니다.

<control:ComboBoxVirtualizing x:Name="comboboxVirtualizing">
    <control:ComboBoxVirtualizing.ItemTemplate>
        <DataTemplate>
            <TextBlock Text="{Binding Value}" />
        </DataTemplate>
    </control:ComboBoxVirtualizing.ItemTemplate>
</control:ComboBoxVirtualizing>

ItemsSource에 데이터를 할당합니다.

comboboxVirtualizing.ItemsSource = Enumerable.Range(0, 1000)
    .Select(i => new KeyValuePair<int, string>(i, i.ToString()))
    .ToArray();

이제 프로그램을 실행하여 속도가 개선됐는지 테스트해보세요.

[IIS] 최대 업로드 크기 설정

해구름 — Mon, 20 Oct 2025 12:29:05 +0900

IIS를 사용할 때 발생할 수 있는 파일업로드 오류 및 대응방법

에러유형1 : 요청 엔터티가 너무 크기 때문에 페이지가 표시되지 않습니다.

IIS 홈에서 [요청 필터링]을 선택합니다.
우측 패널에서 [기능 설정 편집...]을 클릭 후, [허용되는 최대 콘텐츠 길이(바이트)(C) :]필드 값을 원하는 만큼 늘려줍니다.

에러유형2 : Maximum request length exceeded.

[최대 요청 길이를 초과했습니다.] 또는 [Maximum request length exceeded.]오류가 발생하는 경우에는 web.config 설정을 변경해주세요.

<httpRuntime>의 maxRequestLength를 설정해주세요. (KB 단위)

<configuration>
    <system.web>
        <httpRuntime maxRequestLength="10240" />
    </system.web>
</configuration>

IIS7 이상의 경우에는 <requestLimits>의 maxAllowedContentLength를 설정해주세요. (Byte 단위)

 <system.webServer>
   <security>
      <requestFiltering>
         <requestLimits maxAllowedContentLength="10485760" />
      </requestFiltering>
   </security>
 </system.webServer>

[MS SQL] MS SQ Server 설치

해구름 — Thu, 25 Sep 2025 17:46:38 +0900

이 포스트에서는 SQL Server Express를 기준으로 설명합니다. https://www.microsoft.com/ko-kr/download/details.aspx?id=104781에서에서 MS SQL Express 설치 파일일 다운로드 합니다.
설치 파일을 실행 후 사용자 지정을 클릭 후, 하단의 [설치] 버튼을 클릭합니다.
[새 SQL Server 독립 실행형 설치 또는 기존 설치에 기능 추가]를 클릭합니다.
[새로 설치]를 선택합니다.
설치하려는 기능을 선택해주세요.
인스턴스 이름을 압룍해주세요.
서버 구성에서는 특별한 설정을 하지 않습니다.
[혼합 모드]를 선택하고 비밀번호를 입력하세요.
FILESTREAM을 사용하시는 경우 기능을 활성화해주세요.
설치가 완료된 후, 외부에서 접근가능하게 하려면 [TCP/IP]를 활성화해야합니다. 먼저 키보드에서 [Windows]키 + [R]키를 누르고 [services.msc]를 입력하고 실행해주세요.
SQL Server 인스턴스를 선택하고 중지시키세요.
Windows 운영체제의 시작에서 [SQL Server 구성관리자]를 검색하여 실행하세요.
[SQL Server 네트워크 구성]에서 대상 인스턴스를 선택한 후, [TCP/IP]를 더블클릭 해주세요.
[사용]을 [예]로 변경해주세요.
[IP 주소] 탭을 선택하고 [IP All] 항목의 [TCP 동적포트] 값을 설정해주세요. 기본 값은 1433이지만 보안을 위해 다른 값으로 설정이 권장됩니다.
이제 서비스에서 다시 SQL Server 인스턴스를 시작해주세요.
방화벽을 해제해주세요. 키보드에서 [Windows]키 + [R]키를 누르고 [wf.msc]를 입력하고 실행해주세요.
[인바운드 규칙]을 선택하시고, [새 규칙]을 클릭하세요.
포트를 선택하세요.
위에서 설정한 포트번호를 입력하신 후, [다음]을 계속 클릭하여 추가해주세요.
이제 접속이 가능한지 테스트해주세요.

[Linux] 하모니카OS 프로그램 추가제거

해구름 — Fri, 19 Sep 2025 15:03:47 +0900

GUI 기반 패키지 관리 프로그램

하모니카OS를 설치하면 다음과 같은 GUI 기반 패키지 관리 프로그램이 제공됩니다.

소프트웨어 매니저 : mintinstall이라는 패키지 관리 프로그램이며, 패키지 검색, 설치 및 제거가 가능합니다. 하모니카OS 설치 후 나타나는 "환영합니다" 프로그램에서 기본적으로 소개하는 패키지 관리 프로그램입니다.
소프트웨어 : 그놈 프로젝트의 패키지 관리 프로그램이며, 패키지 검색, 설치 및 제거가 가능합니다.

위의 [소프트웨어 매니저]와 [소프트웨어]는 설치 패키지 내역을 공유하지 않습니다. 각각 개별적으로 설치된 패키지를 관리합니다.

패키지 관리 프로그램

리눅스에서 소프트웨어는 패키지 형태로 관리합니다. 리눅스의 패키지 매니저는 크게 데비안 계열의 apt와 레드햇계열의 rpm으로 나누어집니다.

데비안 계열의 리눅스에서는 apt(Advanced Package Tool)를 패키지 관리 프로그램으로 제공합니다. 1998년 데비안 2.0에서 apt-get이라는 이름으로 처음 등장한 후로, 점차 발전 통합되어 현재는 apt라는 명령어로 제공됩니다. 데비안 계열 리눅스로는 데비안, 우분투, 리눅스 민트, 하모니카OS가 있으며, 이러한 운영체제에서는 apt를 사용할 수 있습니다. apt는 다음과 같은 명령어를 제공합니다.

APT명령여 내역

apt list --installed : 설치된 패키지 목록
apt list --installed 패키지명 : 설치된 패키지 검색
apt search 검색어 : 검색어를 포함하는 패키지 검색
apt show 패키지명 : 패키지 상세정보
apt purge 패키지명 : 패키지 삭제 (설정파일도 삭제)
apt remove 패키지명 : 패키지 삭제 (설정파일 남겨둠)
apt upgrade : 패키지 업그레이드
apt --only-upgrade install 패키지명 : 특정 패키지명 업그레이드
apt list--upgradable : 업그레이드 가능 패키지 내역
apt install ./패키지명.deb : 패키지 설치
apt update : 패키지 저장소 업데이트

.deb 파일 설치

데비안 계열 리눅스에서 패키지는 .deb 확장자를 가집니다. 다운로드한 .deb 파일은 다음과 같이 apt 명령어로 설치할 수도 있고, dpkg 명령어로도 설치할 수 있습니다. dpkg는 1994년에 등장하였으며, apt 보다 먼저 등장한 데비안 패키지 관리프로그램입니다.

apt install ./패키지명.deb
dpkg -i 패키지명.deb

.deb 파일 삭제

apt purge 패키지명 (설정파일도 삭제)
apt remove 패키지명 (설정파일 남겨둠)
dpkg -r 패키지명

설치된 .deb 패키지 검색

dpkg -l : 설치된 패키지 내역 조회
dpkg -l 패키지명 : 특정 패키지 조회
dpkg -l | drep 검색어 : 검색어가 포함된 패키지 검색

[Linux] 하모니카 OS에서 원격접속

해구름 — Fri, 19 Sep 2025 11:58:39 +0900

Windows 운영체제에서 원격접속은 RDP(Remote Desktop Protocol, 원격 데스크톱 프로토콜)을 사용하지만, 리눅스에서 원격접속은 XRDP를 사용합니다. 하모니카는 XRDP를 기본적으로 제공합니다. 따라서 하모니카OS 설치 후 방화벽만 열어주시면 원격접속이 가능합니다. 이 글은 하모니카OS 8을 기준으로 작성되었습니다.

원격접속 포트 설정

기본적으로 원격접속을 위해 3389 포트를 사용합니다. 다른 포트로 변경하려면 아래 절차를 진행하세요.

터미널을 실행합니다.
아래 명령어를 입력하여 xrdp.ini 파일을 나노 편집기로 엽니다.
sudo nano /etc/xrdp/xrdp.ini
port=3389를 찾아 원하는 포트번호로 변경 후, 파일을 저장합니다.
아래 명령어를 입력하여 xrdp-sesman.ini 파일을 나노 편집기로 엽니다.
sudo nano /etc/xrdp/xrdp-sesman.ini
ListenPort=3389가 있다면 원하는 포트번호로 변경 후 저장하세요. ListenPort=3389가 없으면 무시하셔도 됩니다.

방화벽 열기

하모니카 OS는 ufw를 통해 방화벽을 관리합니다.
터미널(Ctrl+Alt+T) 실행 후 다음 명령을 실행해주세요.
(3389가 아닌 다른 포트를 사용한다면, 해당 포트번호를 입력하세요)

sudo ufw allow 3389
sudo ufw reload

Xrdp 재시작

설정을 마무리했으면 터미널에서 다음을 실행하여 Xrdp를 재시작해주세요..

sudo systemctl restart xrdp

오류 대응

X server could not be started 가 발생하는 경우 : Windows 운영체제의 [원격 데스크톱 연결] 프로그램에서 [옵션 표시]를 클릭하고 옵션을 기본 값으로 바꾸어보세요. 예를들어 해상도가 32비트가 아니라면 32비트로 변경후 다시 시도해보세요.
원격접속 오류의 원인을 로그로 확인해보세요. 터미널에서 아래 명령을 입력하면 로그를 확인하실 수 있습니다.

cat /var/log/xrdp-sesman.log

[Linux] 하모니카 리눅스 설치

해구름 — Thu, 18 Sep 2025 18:40:26 +0900

설치방법

https://docs.hamonikr.org/hamonikr-8.0/install에 방문하여 ISO를 다운로드합니다.
https://pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/에 방문하여 Universal USB Installer를 다운로드합니다.
Universal USB Installer를 실행하고, 아래 설정을 참고하여 하모니카 리눅스 ISO를 선택하여 설치용 USB를 만들어주세요.
- Step1에는 USB 드라이브를 선택해주세요.
- Step2의 리눅스 유형은 Linux Mint로 선택해주세요.
- Step3에서는 Showing All ISO 체크박스를 체크하고, 다운받은 iso 파일을 선택하세요.
- Step4는 적당히 선택해주세요. 여기에서는 4089MB를 선택했습니다.
- 하단의 [Next] 버튼을 클릭하여 USB에 리눅스 설치파일을 복사하세요.
리눅스 설치 USB가 만들어지면, 리눅스를 설치할 PC에 USB를 삽입 후 부팅하세요.
먼저 설치할 PC의 BIOS 설정으로 진입해주세요.
- UEFI 설정 : UEFI가 비활성화 되어있다면, 활성화 해주세요.
- 부팅순서 설정 : 부팅 시 USB 장치가 가장 먼저 읽히도록 변경합니다.
하모니카 설치를 시작합니다.
처음에는 하모니카 체험을 위한 리눅스 환경이 로드됩니다. 바탕화면의 [설치] 아이콘을 클릭하여 설치를 진행하세요.

[ASP.NET] IIS 호스팅 시 CS0433 오류

해구름 — Fri, 27 Jun 2025 09:22:30 +0900

오류내용

APS.NET을 IIS에 호스팅 시 아래와 같이 오류가 발생할 수 있습니다.

'/' 응용 프로그램에 서버 오류가 있습니다.

컴파일 오류

설명: 이 요청을 제공하는 데 필요한 리소스를 컴파일하는 동안 오류가 발생했습니다. 아래의 오류 정보를 확인한 다음 소스 코드를 적절하게 수정하십시오.

컴파일러 오류 메시지: CS0433: 'ASP.app_example_ascx' 형식이 'c:\Windows\Microsoft.NET\Framework\v4.0\Temporary ASP.NET Files\root\e42c5b\App_Web_e42c5b.dll' 및 'c:\Windows\Microsoft.NET\Framework\v4.0\Temporary ASP.NET Files\root\e13383b\App_Web_e13383b.dll'에 모두 있습니다.

소스 오류:

줄 09:	<div class="panel">
줄 10:		<div class="panel-default">
줄 11:			<uc:Example ID="example" runat="server" />
줄 12:		</div>
줄 13:	</div>

소스 파일: c:\iis\example\MasterPage.master 줄: 11

해결방법

IIS에서 해당 웹사이트를 재시작하시면 문제가 해결됩니다.

Windows 원격접속 시 이메일 발송

해구름 — Fri, 20 Jun 2025 14:41:36 +0900

Windows 운영체제에 원격 접속을 하는 경우, 특정 사람에게 메일을 발송하는 방법을 정리하였습니다.

먼저 메일발송용 PowerShell을 작성하여 파일로 저장해두세요.

# 메일내용
$From = "test@example.com"
$To = "test@example.com"
$Subject = "원격접속 알림"
$Body = "원격접속이 감지되었습니다"

# 접속정보
$SmtpServer = "stmp.example.com"
$Port = 587
$Username = "userName"
$Password = ConvertTo-SecureString "userPassword" -AsPlainText -Force

# 메일발송
$Credential = New-Object System.Management.Automation.PSCredential ($Username, $Password)
Send-MailMessage -From $From -To $To -Subject $Subject -Body $Body -SmtpServer $SmtpServer -Port $Port -UseSsl -Credential $Credential

시작메뉴에서 작업스케줄러를 검색하여 실행해주세요.
[작업 만들기]를 클릭해주세요.
작업 스케줄러가 실행되면 [일반] 탭에서 [이름]을 입력해주세요.
[트리거] 탭에서 [새로 만들기]를 클릭하세요.
[터미널 서버 세션 연결 상태]를 선택하고 [원격 컴퓨터에서 연결]을 선택하세요.
[동작] 탭에서 [새로 만들기]를 클릭하세요.
[프로그램 시작]을 선택하고, 위에서 작성한 PowerShell 파일을 선택하시고 [확인]버튼을 클릭하세요.
[확인]을 클릭하여 작업스케줄러를 추가하면, 앞으로 원격접속이 성공할 때 마다 메일이 발송됩니다.