์ผ๋ฐ ์ค์
์ง์ ๋ ์๊ฐ ๋์ ํ๋์ด ์์ผ๋ฉด ์๋ ๋ก๊ทธ์์๋ฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ: 1์๊ฐ
์ฌ์ฉ์๋ณ ๋์ ๋ณต์ฌ/์ด๋/์ญ์ ์์
์๋ฅผ ์ ํํฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ: 5
์คํ ๋ฆฌ์ง ๊ฒฝ๋ก ์ค์
โ ๏ธ ์ฃผ์์ฌํญ
- ๊ฒฝ๋ก ๋ณ๊ฒฝ ์ ๊ธฐ์กด ํ์ผ์ ์๋์ผ๋ก ์ด๋๋์ง ์์ต๋๋ค.
- ๋ณ๊ฒฝ ์ ๊ธฐ์กด ํ์ผ์ ์ ๊ฒฝ๋ก๋ก ์ง์ ์ด๋ํด์ฃผ์ธ์.
- ์ ์ฅ ํ ํ์ด์ง๋ฅผ ์๋ก๊ณ ์นจํด์ผ ์ ์ฉ๋ฉ๋๋ค.
์ธ๋ถ ์ ์ ์ค์
๐ WebDAV ์ฐ๊ฒฐ
Windows ํ์๊ธฐ์์ ๋คํธ์ํฌ ์์น๋ก ์ฐ๊ฒฐํ ์ ์์ต๋๋ค.
๋คํธ์ํฌ ์์น ์ถ๊ฐ ๋ฐฉ๋ฒ:
- ๋ด PC ์ฐํด๋ฆญ โ "๋คํธ์ํฌ ์์น ์ถ๊ฐ"
- "๋ค์" โ "์ฌ์ฉ์ ์ง์ ๋คํธ์ํฌ ์์น ์ ํ" โ "๋ค์"
- ์ ํ์๊ธฐ ์ฃผ์ ์
๋ ฅ โ "๋ค์"
- ์ฌ์ฉ์๋ช
๊ณผ ๋น๋ฐ๋ฒํธ ์
๋ ฅ
- ์ํ๋ ์ด๋ฆ ์ง์ โ "๋ง์นจ"
๐ ์ธ๋ถ ์ ์ (์ธ๋ถ๋ง์์ ์ฐ๊ฒฐ)
WebDAV๋ ์๋ฒ๊ฐ ์ธ๋ถ์ ๊ณต๊ฐ๋ URL์ด ์์ผ๋ฉด ์ด๋์๋ ์ ์ ๊ฐ๋ฅํฉ๋๋ค. ์ ์ฃผ์๋ ํ์ฌ ์ ์ ์ค์ธ ์ฌ์ดํธ URL ๊ธฐ๋ฐ์ผ๋ก ์๋ ์์ฑ๋ฉ๋๋ค. ์์คํ
์ค์ ์์ ์ธ๋ถ URL์ ์ค์ ํ๋ฉด ์ธ๋ถ ์ ์ ์ฃผ์๊ฐ ๋ณ๋ ํ์๋ฉ๋๋ค.
โ ๏ธ HTTPS ํ์: Windows ํ์๊ธฐ WebDAV๋ ๊ธฐ๋ณธ์ ์ผ๋ก HTTPS๋ง ํ์ฉํฉ๋๋ค. HTTP๋ฅผ ํ์ฉํ๋ ค๋ฉด ํด๋ผ์ด์ธํธ PC์์ ์๋ ๋ช
๋ น ์คํ ํ ์ฌ๋ถํ
:
reg add HKLM\SYSTEM\CurrentControlSet\Services\WebClient\Parameters /v BasicAuthLevel /t REG_DWORD /d 2 /f
โ ๏ธ ํ์ผ ํฌ๊ธฐ ์ ํ ์๋ด
Windows ํ์๊ธฐ WebDAV๋ ๋จ์ผ ํ์ผ ์ต๋ 4GB๊น์ง ์
๋ก๋ ๊ฐ๋ฅํฉ๋๋ค.
์๋ฒ ์ค์ (ํ์):
ํด๋ผ์ด์ธํธ(PC) ์ค์ (๋ ์ง์คํธ๋ฆฌ ๋ณ๊ฒฝ ํ์):
- ๊ด๋ฆฌ์ ๊ถํ์ผ๋ก ๋ช
๋ น ํ๋กฌํํธ(CMD) ์คํ
- ์๋ ๋ช
๋ น์ด ์
๋ ฅ ํ PC ์ฌ๋ถํ
:
reg add HKLM\SYSTEM\CurrentControlSet\Services\WebClient\Parameters /v FileSizeLimitInBytes /t REG_DWORD /d 4294967295 /f
4GB ์ด์ ํ์ผ์ ์น ๋ธ๋ผ์ฐ์ ์์ ์
๋ก๋ํ๊ฑฐ๋, ์๋ํํฐ WebDAV ํด๋ผ์ด์ธํธ๋ฅผ ์ด์ฉํ์ธ์:
- RaiDrive โ ๋ฌด๋ฃ, ๋คํธ์ํฌ ๋๋ผ์ด๋ธ๋ก ๋ง์ดํธ
- Cyberduck โ ๋ฌด๋ฃ, ํ์ผ ์ ์ก ํด๋ผ์ด์ธํธ
- WinSCP โ ๋ฌด๋ฃ, WebDAV ์ง์ ํ์ผ ๊ด๋ฆฌ์
๋ก๊ทธ์ธ ํ๋ฉด ์ค์
๋ก๊ทธ์ธ ํ๋ฉด์ ํ์๋๋ ๋ก๊ณ ์ด๋ฏธ์ง์
๋๋ค. (๊ถ์ฅ: 128x128px)
๋ก๊ทธ์ธ ํ๋ฉด์ ๋ฐฐ๊ฒฝ ์ด๋ฏธ์ง์
๋๋ค. (๊ถ์ฅ: 1920x1080px)
๋ฐฐ๊ฒฝ ์ด๋ฏธ์ง๋ฅผ ํ๋ฉด์ ํ์ํ๋ ๋ฐฉ์์
๋๋ค.
๋ฐฐ๊ฒฝ ์ด๋ฏธ์ง์ ์ ์ฉํ ํํฐ๋ฅผ ์ ํํ์ธ์.
๐ผ๏ธ ์ธ๋ค์ผ ์ค์
์ธ๋ค์ผ ํด์๋์
๋๋ค. ํด์๋ก ์ ๋ช
ํ์ง๋ง ํธ๋ํฝ์ด ์ฆ๊ฐํฉ๋๋ค.
ํ์ธ ์ค...
์บ์๋ ์ธ๋ค์ผ์ ๋ชจ๋ ์ญ์ ํฉ๋๋ค. ๋ค์ ์กฐํ ์ ์๋์ผ๋ก ๋ค์ ์์ฑ๋ฉ๋๋ค.
๊ฒ์ ์ธ๋ฑ์ค ์ค์
๐ง ์ด๋ฉ์ผ(SMTP) ์ค์
์์ด๋/๋น๋ฐ๋ฒํธ ์ฐพ๊ธฐ ๊ธฐ๋ฅ์ ์ฌ์ฉ๋ฉ๋๋ค. ์ค์ ํ์ง ์์ผ๋ฉด PHP mail() ํจ์๋ฅผ ์ฌ์ฉํฉ๋๋ค.
๐ ์ฃผ์ ์ด๋ฉ์ผ ์๋น์ค SMTP ์ค์
| ์๋น์ค |
ํธ์คํธ |
ํฌํธ |
์ํธํ |
๋น๊ณ |
| Gmail |
smtp.gmail.com |
587 |
TLS |
์ฑ ๋น๋ฐ๋ฒํธ ํ์ (2๋จ๊ณ ์ธ์ฆ) |
| Naver |
smtp.naver.com |
587 |
TLS |
POP3/SMTP ์ฌ์ฉ ์ค์ ํ์ |
| Daum/Kakao |
smtp.daum.net |
465 |
SSL |
์ธ๋ถ๋ฉ์ผ ์ฌ์ฉ ์ค์ ํ์ |
| Outlook |
smtp.office365.com |
587 |
TLS |
์ฑ ๋น๋ฐ๋ฒํธ ๊ถ์ฅ |
โ ๏ธ Gmail ์ฌ์ฉ ์ ์ฃผ์
- Google ๊ณ์ ์์ 2๋จ๊ณ ์ธ์ฆ์ ํ์ฑํํ์ธ์.
- ์ฑ ๋น๋ฐ๋ฒํธ๋ฅผ ์์ฑํ์ฌ SMTP ๋น๋ฐ๋ฒํธ๋ก ์ฌ์ฉํ์ธ์.
- ์ผ๋ฐ ๋น๋ฐ๋ฒํธ๋ ๋ณด์ ์ ์ฑ
์ผ๋ก ์ฐจ๋จ๋ฉ๋๋ค.
๐ OnlyOffice ์ค์
OnlyOffice Document Server์ URL์
๋๋ค. HTTPS ๋ฆฌ๋ฒ์ค ํ๋ก์ ์ฌ์ฉ ์: https://๋๋ฉ์ธ/oo
Docker ์คํ ์ JWT_SECRET์ ์ค์ ํ๋ค๋ฉด ๋์ผํ ๊ฐ์ ์
๋ ฅํ์ธ์. JWT_ENABLED=false๋ก ์ค์นํ๋ค๋ฉด ๋น์๋์ธ์.
๐ JWT ์ํฌ๋ฆฟ ํค ํ์ธ ๋ฐฉ๋ฒ
1. Docker ํ๊ฒฝ๋ณ์์์ ํ์ธ
docker inspect [์ปจํ
์ด๋๋ช
] | grep JWT_SECRET
2. ์ปจํ
์ด๋ ๋ด๋ถ ์ค์ ํ์ผ์์ ํ์ธ
docker exec [์ปจํ
์ด๋๋ช
] cat /etc/onlyoffice/documentserver/local.json | grep secret
3. ์คํ ์ค์ธ ์ปจํ
์ด๋์ ํ๊ฒฝ๋ณ์ ์ ์ฒด ํ์ธ
docker exec [์ปจํ
์ด๋๋ช
] env | grep JWT
๐ OnlyOffice ์ค์น ๋ฐฉ๋ฒ (Docker)
# JWT ๋ณด์ ์ฌ์ฉ (๊ถ์ฅ)docker run -d -p 8080:80 --restart=always \
-e JWT_SECRET=your-secret-key \
onlyoffice/documentserver
# JWT ๋นํ์ฑํ (๊ฐ๋จ ์ค์น)docker run -d -p 8080:80 --restart=always \
-e JWT_ENABLED=false \
onlyoffice/documentserver
๐ Apache ๋ฆฌ๋ฒ์ค ํ๋ก์ ์ค์
์นํ๋ ๋๋ฉ์ธ์ SSL(443) ์ค์ ํ์ผ์์ </VirtualHost> ๋ฐ๋ก ์์ ์ถ๊ฐํ์ธ์.
(์: httpd-vhosts.conf ๋๋ httpd-ssl.conf)
# WebSocket ํ๋ก์RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule ^/oo/(.*) ws://OnlyOffice๋ด๋ถIP:8080/$1 [P,L]
# OnlyOffice ๋ฆฌ๋ฒ์ค ํ๋ก์<Location /oo/>
ProxyPass http://OnlyOffice๋ด๋ถIP:8080/
ProxyPassReverse http://OnlyOffice๋ด๋ถIP:8080/
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto "https"
RequestHeader set X-Forwarded-Host "๋๋ฉ์ธ"
</Location>
# ์บ์ ํ๋ก์<Location /cache/>
ProxyPass http://OnlyOffice๋ด๋ถIP:8080/cache/
ProxyPassReverse http://OnlyOffice๋ด๋ถIP:8080/cache/
</Location>
โป OnlyOffice๋ด๋ถIP โ ์๋ฒIP ๋๋ Docker IP๋ก, ๋๋ฉ์ธ โ ์ค์ ๋๋ฉ์ธ์ผ๋ก ๋ณ๊ฒฝํ์ธ์. ์ค์ ํ Apache ์ฌ์์ ํ์.
์ง์ ํ์ผ: docx, xlsx, pptx, doc, xls, ppt, odt, ods, odp, txt, csv, html ๋ฑ
๐ ๋๊ธฐํ / ๋ฐฑ์
์คํ ๋ฆฌ์ง ๊ฐ ํ์ผ์ ๋๊ธฐํํ๊ฑฐ๋ ๋ฐฑ์
ํฉ๋๋ค.
๐พ ์ค์ ๋ฐฑ์
/ ๋ณต์
์ฌ์ฉ์, ์คํ ๋ฆฌ์ง, ๊ถํ, ์์คํ
์ค์ ์ ๋ฐฑ์
ํ๊ฑฐ๋ ๋ณต์ํฉ๋๋ค. (์ค์ ํ์ผ์ ํฌํจ๋์ง ์์ต๋๋ค)
๐ ์๋ ๋ฐฑ์
FileStation ์ค์น ๊ฒฝ๋ก์ data/ ํด๋๋ฅผ ํต์งธ๋ก ๋ณต์ฌํด๋ ๋ฐฑ์
๋ฉ๋๋ค.
์ค์ ํ์ผ์ ๋ฐฑ์
ํ๋ ค๋ฉด ๊ฐ์ธํด๋(users/)์ ๊ณต์ ํด๋(shared/)๋ ํจ๊ป ๋ณต์ฌํ์ธ์.
๋ฐฑ์
์ ์ธ ํญ๋ชฉ: *.lock, file_index.db, trash_files/, *.log