해나래

[VS Code] Inline Code Suggestion 활성화

해구름 — Fri, 24 Jul 2026 16:25:33 +0900

VisualStudio Code에서 코드를 작성 중에 AI가 코드를 제안해주는 Inline Code Suggestion 기능을 활성화하는 법을 설명합니다.

방법1 : Github Copilot

VS Code에 기본 포함되어있는 Github Copilot를 사용하면 가장 쉽고 빠르게 Code Suggestion을 이용할 수 있습니다. Github Copilot 무료 플랜은 월 2천회까지만 Inline Suggestion을 제공합니다. 월 10달러 유료 플랜을 구독하면 무제한으로 이용가능합니다. (2026년 7월 기준)

VS Code의 우측 하단에 Github Copilot 아이콘을 클릭합니다.
Github에 로그인합니다. 바로 Inline Code Suggestion이 활성화됩니다.
VS Code의 우측 하단의 Github 아이콘을 클릭하여, Inline Suggestion을 강제로 활성화하거나 비활성화할 수 있으며 사용량도 볼 수 있습니다.

방법2 : Gemini

VisualStudio Code의 Extension에서 Gemini를 설치하면 Google Gemini AI에 의해서 Code Suggestion이 활성화됩니다. 무료 플랜도 월 180,000회 기능을 제공하기 때문에, 사실상 무제한으로 쓸수 있습니다.

VS Code의 좌측에서 Extensions 버튼을 누릅니다.
Extensions에서 gemini를 검색하고 설치해주세요.
설치가 완료되면 VS Code를 재시작 하세요.
VS Code의 우측하단에 Gemini 아이콘을 클릭하세요.
Gemini Code Assist 창이 나타나면 [Sign in] 버튼을 클릭하여 로그인하세요.
권한 설정 팝업이 나타나면 [Enable API] 버튼을 클릭하세요.
Google Cloud API 서비스를 활성화하신 후, 프로젝트 생성 안내가 나타나면 프로젝트를 생성해주세요.
프로젝트 생성이 완료되면, 다시 VS Code로 돌아와 우측하단의 [Gemini 아이콘]을 클릭하고, [Select Project]를 선택하세요.
기다리다보면 아래와 같이 프로젝트를 선택할 수 있게 목록이 나타날 것입니다. 프로젝트가 나타나면 선택해주세요.
설정이 완료되면 아래와 같이 아이콘이 변경됩니다. 너무 시간이 걸리거나 문제가 발생한다면 위 과정을 다시 한번 진행해보세요.
VS Code 우측 아래 Gemini 아이콘을 클릭하고 "Automatic Code Completion Status : On" 상태로 변경해주세요. 이제 Code Suggestion 기능이 활성화됩니다.

방법3 : Local LLM 사용

PC에 AI를 설치하고 Local LLM을 통해 Inline Code Suggestion을 사용할 수 있습니다. VS Code Extension에서 "Continue"를 설치하고 로컬 LLM 플렛폼인 "Ollama"를 통해 AI를 실행하시면 됩니다. 여기에서는 Windows 11 환경을 기준으로 설치 과정을 설명합니다.

VS Code의 Extensions에서 Continue를 설치하세요.
Ollama 웹사이트(https://ollama.com/download/windows)에 방문하여 Ollama를 설치하세요.
Ollama 설치가 완료되면 [Windows PowerShell]을 실행하신 후, ollama -v 명령을 통해 Ollama가 정상설치되었는지 확인하세요.
PS C:\> ollama -v
ollama version is 0.32.3
이제 Local LLM을 설치해야 합니다. 여기서는 Continue 가이드에서 소개하는 알리바바의 "qwen2.5-coder:1.5b" AI Model을 설치할 것입니다. "qwen2.5-coder:1.5b"는 프로그래밍 코드의 실시간 자동완성에 특화된 가벼운 AI Model이며, 약 2GB의 메모리를 사용합니다. AI는 빠르게 발전하는 상황이므로, 설치하는 시점에 가장 적절한 AI가 무엇인지 검색하고 사용하시기 바랍니다.
PowerShell에서 ollama pull qwen2.5-coder:1.5b 명령어를 통해 "qwen2.5-coder:1.5b"를 다운로드하세요.
PS C:\> ollama pull qwen2.5-coder:1.5b
pulling manifest
pulling 29d8c98fa6b0: 100% ▕████████▏ 986 MB
pulling 66b9ea09bd5b: 100% ▕████████▏ 68 B
pulling 1e65450c3067: 100% ▕████████▏ 1.6 KB
pulling 832dd9e00a68: 100% ▕████████▏ 11 KB
pulling 152cb442202b: 100% ▕████████▏ 487 B
verifying sha256 digest
writing manifest
success
ollama run qwen2.5-coder:1.5b 명령을 통해 AI를 실행하고 잘 동작하는지 테스트해주세요. /bye를 입력하시면 종료하실 수 있습니다.
PS C:\> ollama run qwen2.5-coder:1.5b
>>> explain functions in one sentence
A function is a reusable block of code designed
to perform a specific task, which can
take inputs and return outputs.

>>> /bye
참고로 ollama list 명령을 통해 설치된 AI 내역을 조회할 수 있습니다.
PS C:\> ollama list
NAME ID SIZE MODIFIED
qwen2.5-coder:1.5b d7372fd82851 986 MB 10 minutes ago
ollama ps 명령을 통해 실행 중인 AI을 조회할 수 있습니다.
PS C:\> ollama ps
NAME ID SIZE PROCESSOR CONTEXT UNTIL
qwen2.5-coder:1.5b d7372fd82851 1.2 GB 42%/58% CPU/GPU 4096 2 minutes from now
이제 VS Code를 실행하고 우측 하단의 Continue 아이콘을 클릭하세요.
상단에 나타난 패널에서 Open Settings를 클릭하세요.
아래와 같이 ① Open Settings → ② Configs → ③ Open configuration 버튼을 순서대로 클릭하세요.
config.yaml이 나타나면 아래와 같이 입력하세요.

name: Main Config
version: 1.0.0
schema: v1
models:
- name: qwen2.5-coder:1.5b
provider: ollama
model: qwen2.5-coder:1.5b
roles:
- autocomplete
아래와 같이 Models 버튼을 클릭 후 Autocomplete를 "qwen2.5-coder:1.5b"로 설정해주세요.
마지막으로 AutoComplete 기능을 활성화해야합니다. 먼저 VS Code 우측 아래 Continue 아이콘을 클릭해주세요.

그 다음 "Enable autocomplete"를 클릭하시면 AutoComplete 기능이 활성화됩니다.

Autocomplete 기능이 성공적으로 활성화되면 아래와 같이 아이콘이 나타납니다.

[React] VisualStudio React 프로젝트에 Sahdcn-UI 추가

해구름 — Mon, 29 Jun 2026 13:37:24 +0900

VisualStudio 2026에서 생성한 React 프로젝트에 Shadcn-UI를 추가하는 방법에 대해 정리합니다.

TailwindCSS 설치

Tailwindcss 홈페이지에서 설치 가이드에 따라 설치합니다. VisualStudio에서 생성한 React 프로젝트는 Vite를 사용합니다. 따라서 설치가이드에서 Vite를 사용하는 부분을 찾아 진행해야 합니다.

tailwindcss와 @tailwincss/vite 설치
npm install tailwindcss @tailwindcss/vite

vite.config.ts 파일 열고 Tailwindcss 설정 추가

import tailwindcss from '@tailwindcss/vite';

export default defineConfig({
  ...
  plugins: [
    ...
    tailwindcss(),
  ],
})

프로젝트의 src폴더에 main.css (main.css 파일이 없다면 index.css)파일에 @import 추가
@import "tailwindcss";

Tailwind CSS 테스트 코드 작성 및 테스트

<h1 class="text-3xl font-bold underline">
  Hello world!
</h1>

Shadcn-UI 설치

이미 프로젝트는 생성되어 있으므로 Shadcn-UI의 Installation/Existing Project를 참고하여 설치를 진행합니다다.

1번 Create Project와 2번 Add Tailwind CSS는 이미 진행했으므로 생략합니다.

tsconfig.json 파일을 열고 아래와 같은 compilerOptions에 bakseUrl과 paths를 추가합니다.

{
  "compilerOptions": {
    "ignoreDeprecations": "6.0",
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

tsconfig.app.json 파일을 열고 아래와 같은 compilerOptions에 bakseUrl과 paths를 추가합니다.

{
  "compilerOptions": {
    "ignoreDeprecations": "6.0",
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

package.json 파일을 열고 @types/node가 설치되어 있는지 확인합니다. 설치되어 있지 않으면, 아래와 같이 설치합니다.
npm install -D @types/node
vite.config.ts를 열고 resolve/alias에 '@'가 src 폴더로 설정되어 있는지 확인합니다. 설정되어 있지 않으면, 아래와 같이 설정합니다.
```
import path from "path"
 
export default defineConfig({
  ...
  resolve: {
    alias: {
      "@": path.resolve(__dirname, "./src"),
    },
  },
})
```
shadcn init 명령어를 통해 초기화를 진행합니다. 아래와 같은 명령을 실행하세요. 아래 명령어가 실행되면 ~/src/componnents 폴더와 ~/src/lib/utils.ts 파일이 생성됩니다.
npx shadcn@latest init
이제 Shadcn-UI 컴포넌트를 추가하고 테스트를 해보세요. 아래 명령어를 추가하면 Button Component가 ~/src/components폴더에 추가됩니다.
npx shadcn@latest add button

소스코드에 Button을 추가해서 테스트해봅니다.

import { Button } from "@/components/ui/button"
 
...
return (
    <div className="flex min-h-svh flex-col items-center justify-center">
      <Button>Click me</Button>
    </div>
  )

[React] VisualStudio 2026에서 React 프로젝트

해구름 — Thu, 25 Jun 2026 18:05:38 +0900

VisualStudio 2026에서 React 프로젝트를 생성하고 빌드할 수 있습니다. 여기선 VisualStudio가 생성한 React 프로젝트의 구조에 대해 설명합니다.

Server 프로젝트

ASP.NET Core 프로젝트로 아래와 같이 생성됩니다.

Properties / launchSettings.json : 개발 환경에서 프로젝트 실행 방법을 설정하는 파일입니다.
```
{
    "$schema": "https://json.schemastore.org/launchsettings.json",
    "profiles": {
        "https": {
            "commandName": "Project",
            "dotnetRunMessages": true,
            "launchBrowser": false,
            "applicationUrl": "https://localhost:7277;http://localhost:5078",
            "environmentVariables": {
                "ASPNETCORE_ENVIRONMENT": "Development",
                "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.SpaProxy"
            }
        }
    }
}
```
1. applicationUrl : 디버깅 시 실행되는 서버의 URL을 정의합니다.
2. launchBrowser : 디버깅 시 웹브라우저가 실행될지 여부를 정의합니다. 기본적으로 false로 설정되어 있어 웹브라우저를 실행하지 않습니다.
3. ASPNETCORE_ENVIRONMENT: Development 값은 실행환경이 개발환경임을 나타냅니다. 값을 Production으로 정의할 경우 Production 환경임을 나타냅니다.
appsettings.json : 애플리케이션 설정값입니다. DB연결 문자, 로깅, 이메일 주소나 전화번호 등 설정 값을 지정합니다.
1. appsettings.json : 애플리케이션 설정 값의 기본 값들을 지정합니다.
2. appsettings.Development.json : 실행환경이 개발환경일 때 사용되는 설정 값입니다.
3. appsettings.Production.json : 배포 시 사용되는 설정 값입니다.
appsettings.json 파일이 먼저 로드되고 appsettings.{ASPNETCORE_ENVIRONMENT}.json 파일이 뒤이어 로드됩니다. 중복되는 이름은 덮어쓰기가 됩니다.
ReactApp1.Server.http : API를 편하게 테스트하기 위해 사용하는 파일입니다. 이 파일은 삭제해도 되고, 개발 중에 직접 수정하면서 개발 중인 API 테스트를 진행해도 됩니다. 호스팅 시에는 사용하지 않습니다.

Client 프로젝트

Client 프로젝트는 아래와 같이 구성됩니다.

launch.json : VisualStudio가 Client 프로젝트를 실행할 때 설정 값을 정의합니다. 주로 브라우저가 로드할 주소 및 폴더 경로에 대한 내용이 포함됩니다.
.oxlintrc.json : 자바스크립트 린터로서 eslint와 같은 역할을 수행합니다. oxlint는 eslint 보다 훨신 빠르게 동작하지만, 최근에 등작한 만큼 규칙과 생태계가 eslint 보다는 제한적입니다.
index.html : 전통적으로 React의 index.html 파일은 주로 src 폴더 하위에 위치하지만, Vite는 프로젝트 루트에 index.html을 위치시킵니다. 역할은 기존과 동일합니다.
package.json : Node.js 설정파일입니다.
tsconfig.json : Typescript 설정파일입니다.
vite.config.ts : Vite 설정파일입니다.

.esproj 파일 : 위 이미지에는 나타나지 않았지만, VisualStudio는 React 프로젝트를 .esproj 파일로 관리합니다. .esproj는 아래와 같은 내용을 포함합니다.

<Project Sdk="Microsoft.VisualStudio.JavaScript.Sdk/1.0.5277448">
    <PropertyGroup>
        <!-- VisualStudio에서 프로젝트 실행 시, 실행할 Command (아래는 package.json의 dev script를 실행함) -->
        <StartupCommand>npm run dev</StartupCommand>
        <!-- JavaScript 테스트 시 루트 경로 -->
        <JavaScriptTestRoot>src\</JavaScriptTestRoot>
        <!-- JavaScript 테스트 프레임워크 -->
        <JavaScriptTestFramework>Vitest</JavaScriptTestFramework>
        <!-- VisualStudio에서 프로젝트를 빌드 할 때 package.json에 설정되어 있는 build script를 실행할지 여부 -->
        <ShouldRunBuildScript>false</ShouldRunBuildScript>
        <!-- build 후 생성된 Production 파일들이 위치할 경로 (아래는 프로젝트루트/dist 폴더에 생성됨을 의미함) -->
        <BuildOutputFolder>$(MSBuildProjectDirectory)\dist</BuildOutputFolder>
    </PropertyGroup>
</Project>

VisualStudio에서 Client 프로젝트를 실행하면 아래와 같은 과정으로 진행됩니다.

.esproj 파일의 StartupCommand에 정의된 npm run dev 명령이 실행됩니다.
npm 명령이 실행되면 Node.js가 실행됩니다.
run dev를 실행하기 위해 Node.js는 package.json을 로드합니다. pakcage.json은 아래와 같은데, 여기에서 scripts/dev에 정의된 값을 Node.js가 실행하게 됩니다. 여기에선 vite가 정의되어 있으므로 Vite가 실행됩니다.
```
{
    "name": "reactapp1.client",
    "private": true,
    "version": "0.0.0",
    "type": "module",
    "scripts": {
        "dev": "vite",
        "build": "tsc -b && vite build",
        "lint": "oxlint",
        "preview": "vite preview"
    }
}
```

Vite가 실행되면 vite.config.ts가 실행됩니다. Vite 파일의 내용은 아래와 같으며, API서버와 통신을 위한 설정이 주로 포함되어있습니다.

import { fileURLToPath, URL } from 'node:url';

import { defineConfig } from 'vite';
import plugin from '@vitejs/plugin-react';
import fs from 'fs';
import path from 'path';
import child_process from 'child_process';
import { env } from 'process';


//1. API서버와 통신을 위해 HTTPS 인증서 경로조회
const baseFolder =
    env.APPDATA !== undefined && env.APPDATA !== ''
        ? `${env.APPDATA}/ASP.NET/https`
        : `${env.HOME}/.aspnet/https`;

console.log("baseFolder: " + baseFolder);

const certificateName = "reactapp1.client";
const certFilePath = path.join(baseFolder, `${certificateName}.pem`);
const keyFilePath = path.join(baseFolder, `${certificateName}.key`);

if (!fs.existsSync(baseFolder)) {
    fs.mkdirSync(baseFolder, { recursive: true });
}


//2. HTTPS 인증서가 없으면 생성
if (!fs.existsSync(certFilePath) || !fs.existsSync(keyFilePath)) {
    if (0 !== child_process.spawnSync('dotnet', [
        'dev-certs',
        'https',
        '--export-path',
        certFilePath,
        '--format',
        'Pem',
        '--no-password',
    ], { stdio: 'inherit', }).status) {
        throw new Error("Could not create certificate.");
    }
}


//3. API서버 주소 정의
const target = env.ASPNETCORE_HTTPS_PORT ? `https://localhost:${env.ASPNETCORE_HTTPS_PORT}` :
    env.ASPNETCORE_URLS ? env.ASPNETCORE_URLS.split(';')[0] : 'https://localhost:7277';


//4. Vite 설정
export default defineConfig({
    plugins: [plugin()],
    resolve: {
        alias: {
            '@': fileURLToPath(new URL('./src', import.meta.url))
        }
    },
    server: {
        proxy: {
            '^/weatherforecast': { target, secure: false }
        },
        port: parseInt(env.DEV_SERVER_PORT || '61552'),
        https: {
            key: fs.readFileSync(keyFilePath),
            cert: fs.readFileSync(certFilePath),
        }
    }
})

마지막으로 Vite는 index.html과 tsconfig.json 등을 읽어 React 프로젝트를 실행하게 됩니다.

[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