서버 설치 · 8 min read · Sep 30, 2025

Ubuntu 20.04에 EteSync 서버 설치하는 방법

EteSync는 연락처, 캘린더 및 작업을 동기화하기 위한 오픈 소스 솔루션입니다. 자체 호스팅되며, 종단 간 암호화를 제공하고, 다른 사용자와 데이터를 공유할 수 있습니다. GNOME 및 KDE 데스크탑과 통합할 수 있으며, 데스크탑, 웹, Android 및 iOS 클라이언트를 통해 접근할 수 있습니다.

이 튜토리얼에서는 Ubuntu 20.04에서 Apache와 함께 EteSync를 설치하는 방법을 보여드리겠습니다.

전제 조건

  • Ubuntu 20.04가 실행되는 서버.
  • 서버 IP가 지정된 유효한 도메인 이름.
  • 서버에 구성된 루트 비밀번호.

시작하기

먼저, 다음 명령어를 실행하여 시스템 패키지를 업데이트된 버전으로 업데이트합니다:

apt-get update -y

모든 패키지가 업데이트되면 다음 단계로 진행할 수 있습니다.

MariaDB 서버 설치

기본적으로 EteSync는 정보를 저장하기 위해 SQLite 데이터베이스를 사용합니다. 여기서는 MariaDB를 데이터베이스 백엔드로 설치하고 사용할 것입니다.

먼저, 다음 명령어를 사용하여 필요한 종속성을 설치합니다:

apt-get install software-properties-common gnupg2 -y

다음으로, 다음 명령어를 사용하여 MariaDB GPG 키와 저장소를 추가합니다:

apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8  
add-apt-repository 'deb [arch=amd64,arm64,ppc64el] http://mirror.lstn.net/mariadb/repo/10.5/ubuntu focal main'

다음으로, MariaDB 저장소를 업데이트하고 다음 명령어로 최신 버전의 MariaDB를 설치합니다:

apt-get install mariadb-server -y

MariaDB 서버 설치 후, 다음 명령어로 MariaDB 셸에 로그인합니다:

mysql

로그인한 후, 다음 명령어로 EteSync용 데이터베이스와 사용자를 생성합니다:

MariaDB [(none)]> create database etesync;  
MariaDB [(none)]> create user etesync@localhost identified by 'securepassword';

다음으로, 다음 명령어로 EteSync 데이터베이스에 모든 권한을 부여합니다:

MariaDB [(none)]> grant all privileges on etesync.* to etesync@localhost;

다음으로, 권한을 플러시하고 다음 명령어로 MariaDB에서 종료합니다:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

작업이 완료되면 다음 단계로 진행할 수 있습니다.

EteSync 설치 및 구성

먼저, EteSync에 필요한 Python 종속성을 설치해야 합니다. 다음 명령어로 모두 설치할 수 있습니다:

apt-get install python3-virtualenv python3-pip gcc libmysqlclient-dev build-essential git -y

모든 종속성을 설치한 후, 다음 명령어로 EteSync의 최신 버전을 다운로드합니다:

git clone https://github.com/etesync/server.git etesync

다운로드가 완료되면 etesync 디렉토리로 변경하고 다음 명령어로 Python 가상 환경을 생성합니다:

cd etesync  
virtualenv -p python3 .venv

다음으로, 다음 명령어로 가상 환경을 활성화합니다:

source .venv/bin/activate

다음으로, 다음 명령어로 모든 요구 사항을 설치합니다:

pip install -r requirements.txt

다음으로, 샘플 구성 파일을 복사합니다:

cp etebase-server.ini.example etebase-server.ini

다음으로, 아래 명령어로 구성 파일을 편집합니다:

nano etebase-server.ini

다음 줄을 추가하거나 수정합니다:

media_root = /opt
allowed_host1 = etesync.example.com

;engine = django.db.backends.sqlite3
;name = db.sqlite3

engine = django.db.backends.mysql
name = etesync
user = etesync
password = securepassword
host = 127.0.0.1
port = 3306

파일을 저장하고 닫은 후, 다음 명령어로 다른 모듈을 설치합니다:

pip3 install daphne  
pip3 install mysqlclient  
pip3 install aioredis

다음으로, 다음 명령어로 정적 파일을 생성하고 데이터베이스를 마이그레이션합니다:

./manage.py collectstatic  
./manage.py migrate

마지막으로, 다음 명령어로 EteSync 서버를 시작합니다:

daphne -b 0.0.0.0 -p 8001 etebase_server.asgi:application

모든 것이 정상이라면 다음과 같은 출력을 얻어야 합니다:

2021-07-09 05:42:28,510 INFO     Starting server at tcp:port=8001:interface=0.0.0.0
2021-07-09 05:42:28,510 INFO     HTTP/2 support not enabled (install the http2 and tls Twisted extras)
2021-07-09 05:42:28,511 INFO     Configuring endpoint tcp:port=8001:interface=0.0.0.0
2021-07-09 05:42:28,512 INFO     Listening on TCP address 0.0.0.0:8001

서버를 중지하려면 CTRL + C를 누릅니다.

다음으로, 다음 명령어로 관리 사용자를 생성합니다:

./manage.py createsuperuser

아래와 같이 사용자 이름, 비밀번호 및 이메일을 제공합니다:

Username: etesync
Email address: [email protected]
Password: 
Password (again): 
Superuser created successfully.

다음으로, 다음 명령어로 Python 가상 환경에서 비활성화합니다:

deactivate

EteSync용 Systemd 유닛 파일 생성

다음으로, EteSync를 관리하기 위한 systemd 유닛 파일을 생성해야 합니다. 다음 명령어로 생성할 수 있습니다:

nano /etc/systemd/system/etesync.service

다음 줄을 추가합니다:

[Unit]
Description=EteSync: End-to-End Encryption to Sync Calender, Contacts, Tasks and Notes.

[Service]
WorkingDirectory=/root/etesync
ExecStart=/root/etesync/.venv/bin/daphne -b 127.0.0.1 -p 8001 -u /tmp/etebase_server.sock etebase_server.asgi:application
User=root
Group=root
Restart=always
RestartSec=5s

[Install]
WantedBy=multi-user.target

파일을 저장하고 닫은 후, 다음 명령어로 systemd 데몬을 다시 로드하여 구성 변경 사항을 적용합니다:

systemctl daemon-reload

다음으로, 다음 명령어로 EteSync 서비스를 시작하고 활성화합니다:

systemctl start etesync  
systemctl enable etesync

EteSync 서비스의 상태를 확인하려면 다음 명령어를 실행합니다:

systemctl status etesync

다음과 같은 출력을 얻을 수 있습니다:

? etesync.service - EteSync: End-to-End Encryption to Sync Calender, Contacts, Tasks and Notes.
     Loaded: loaded (/etc/systemd/system/etesync.service; disabled; vendor preset: enabled)
     Active: active (running) since Fri 2021-07-09 05:45:45 UTC; 5s ago
   Main PID: 16213 (daphne)
      Tasks: 1 (limit: 2353)
     Memory: 48.7M
     CGroup: /system.slice/etesync.service
             ??16213 /root/etesync/.venv/bin/python /root/etesync/.venv/bin/daphne -b 127.0.0.1 -p 8001 -u /tmp/etebase_server.sock etebase_se>

Jul 09 05:45:45 node1 systemd[1]: Started EteSync: End-to-End Encryption to Sync Calender, Contacts, Tasks and Notes..
Jul 09 05:45:46 node1 daphne[16213]: 2021-07-09 05:45:46,993 INFO     Starting server at tcp:port=8001:interface=127.0.0.1, unix:/tmp/etebase_>
Jul 09 05:45:46 node1 daphne[16213]: 2021-07-09 05:45:46,995 INFO     HTTP/2 support not enabled (install the http2 and tls Twisted extras)
Jul 09 05:45:46 node1 daphne[16213]: 2021-07-09 05:45:46,995 INFO     Configuring endpoint tcp:port=8001:interface=127.0.0.1
Jul 09 05:45:46 node1 daphne[16213]: 2021-07-09 05:45:46,997 INFO     Listening on TCP address 127.0.0.1:8001
Jul 09 05:45:46 node1 daphne[16213]: 2021-07-09 05:45:46,998 INFO     Configuring endpoint unix:/tmp/etebase_server.sock

이 시점에서 EteSync가 시작되었고 포트 8001에서 수신 대기하고 있습니다. 이제 다음 단계로 진행할 수 있습니다.

Apache를 리버스 프록시로 구성하기

EteSync에 접근하기 위해 Apache를 리버스 프록시로 설치하고 사용하는 것이 좋습니다. 먼저, 다음 명령어로 Apache 서버를 설치합니다:

apt-get install apache2 -y

Apache 서버를 설치한 후, 다음 명령어로 모든 프록시 모듈을 활성화합니다:

a2enmod proxy proxy_http headers proxy_wstunnel

다음으로, 새로운 Apache 가상 호스트 구성 파일을 생성합니다:

nano /etc/apache2/sites-available/etesync.conf

다음 줄을 추가합니다:


   ServerName etesync.example.com
   ErrorDocument 404 /404.html

   ErrorLog ${APACHE_LOG_DIR}/etebase_error.log
   CustomLog ${APACHE_LOG_DIR}/etebase_access.log combined

   ProxyPreserveHost On
   ProxyPass / http://127.0.0.1:8001/
   ProxyPassReverse / http://127.0.0.1:8001/
   Alias /static /etesync/static

파일을 저장하고 닫은 후, 다음 명령어로 Apache 가상 호스트를 활성화합니다:

a2ensite etesync.conf

다음으로, 다음 명령어로 Apache를 재시작하여 변경 사항을 업데이트합니다:

systemctl restart apache2

다음 명령어를 사용하여 Apache 상태를 확인할 수 있습니다:

systemctl status apache2

다음과 같은 출력을 얻어야 합니다:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2021-07-09 05:50:26 UTC; 5s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 17551 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 17567 (apache2)
      Tasks: 55 (limit: 2353)
     Memory: 5.3M
     CGroup: /system.slice/apache2.service
             ??17567 /usr/sbin/apache2 -k start
             ??17568 /usr/sbin/apache2 -k start
             ??17569 /usr/sbin/apache2 -k start

Jul 09 05:50:26 node1 systemd[1]: Starting The Apache HTTP Server...
Jul 09 05:50:26 node1 apachectl[17558]: AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 45.58.3>

EteSync 관리 콘솔 접근하기

이제 웹 브라우저를 열고 URL http://etesync.example.com/admin/를 사용하여 EteSync 관리 인터페이스에 접근합니다. 다음 페이지로 리디렉션됩니다:

EteSync 로그인

관리 사용자 이름, 비밀번호를 입력하고 로그인 버튼을 클릭합니다. 다음 페이지가 표시됩니다:

사이트 관리

Let’s Encrypt SSL로 EteSync 보안 설정하기

먼저, 도메인에 대한 SSL 인증서를 다운로드하고 설치하기 위해 Certbot Let’s Encrypt 클라이언트를 설치해야 합니다.

다음 명령어로 설치할 수 있습니다:

apt-get install python3-certbot-apache -y

설치가 완료되면, 다음 명령어를 실행하여 도메인 etesync.example.com에 대한 Let’s Encrypt 인증서를 설치할 수 있습니다.

certbot --apache -d etesync.example.com

설치 중에 이메일 주소를 제공하고 서비스 약관에 동의하라는 메시지가 표시됩니다:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for etesync.example.com
Enabled Apache rewrite module
Waiting for verification...
Cleaning up challenges
Created an SSL vhost at /etc/apache2/sites-available/etesync-le-ssl.conf
Deploying Certificate to VirtualHost /etc/apache2/sites-available/etesync-le-ssl.conf
Enabling available site: /etc/apache2/sites-available/etesync-le-ssl.conf

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

다음으로 2를 입력하고 Enter를 눌러 도메인에 대한 무료 SSL 인증서를 다운로드하고 설치합니다. 설치가 성공적으로 완료되면 다음과 같은 출력을 얻어야 합니다:

Enabled Apache rewrite module
Redirecting vhost in /etc/apache2/sites-enabled/etesync.conf to ssl vhost in /etc/apache2/sites-available/
etesync-le-ssl.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://etesync.example.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=etesync.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

결론

축하합니다! Ubuntu 20.04 서버에 EteSync를 Let’s Encrypt SSL과 함께 성공적으로 설치했습니다. 이제 EteSync를 사용하여 캘린더와 연락처를 쉽게 동기화할 수 있습니다.

Share: X/Twitter LinkedIn
#서버 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.