bookstack 설치 [Apache Subdirectry 운영]

설치 작업 노트 [21/05/14]

Apache Subdirectry 운영 설정

OS: Ubuntu 20.04.2 LTS

BookStack v21.04.4

PostgreSQL 12.6 (Ubuntu 12.6-0ubuntu0.20.04.1)

$cd /usr/local/src
$sudo git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch
$sudo mv ./BookStack /var/lib/bookstack
$cd /var/lib/bookstack
$sudo apt install composer
$composer install --no-dev
$sudo rm -rf /var/lib/bookstack
$ln -s /var/lib/bookstack /var/www/

지금까지 프로그램의 배포 및 배포가 완료되었습니다.

■ 설정 파일 수정

.env.example을 복사하여/var/lib/bookstack/.env를 만듭니다. [이것은 중요한 설정 파일입니다. ]

※APP_URL의 설정 부분, 서브 디렉토리 운용의 경우는 말미에 슬래시를 붙이지 않습니다.
예: APP_URL = htps : // 에아 mpぇ. 코 m / 보오 ks ck

그 외, 자신의 환경에 맞게 수정합니다. 이후 실패할 때는 대부분 이 파일의 기술이 문제입니다.

/var/lib/bookstack/.env

APP_KEY=SomeRandomString

APP_URL=https://example.com/bookstack

# Database details
DB_HOST=localhost
DB_DATABASE=database_database
DB_USERNAME=database_username
DB_PASSWORD=database_user_password

# Mail system to use
# Can be 'smtp' or 'sendmail'
MAIL_DRIVER=smtp

# Mail sender details
MAIL_FROM_NAME="BookStack"
[email protected]

# SMTP mail options
# These settings can be checked using the "Send a Test Email"
# feature found in the "Settings > Maintenance" area of the system.
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

다음 폴더에 대한 www-data 사용자에게 액세스 권한 부여

storage

bootstrap/cache

public/uploads

다음 세 가지만 조심하면 좋을지 모르지만/var/lib/bookstack 이하 모든 폴더
액세스 권한을 다시 설정합니다.

sudo chown -hR www-data:www-data /var/lib/bookstack

↓다음 명령을 실행합니다. .env 파일의 APP_KEY=SomeRandomString에 임의 문자가 생성됩니다.

cd /var/lib/bookstack
php artisan key:generate

↓데이터베이스를 업데이트(작성?초기설정?)합니다.

php artisan migrate

↑ 지금까지 설치 설정이 완료되었습니다.

■ Apache 관련 설정 (서브 디렉토리 운영 설정)

■↓subdirectry의 설명 개소(여기의 설정을 그대로 사용했습니다.)
htps //w w. 보오 ks c c p. 코 m / 드 cs / 아 d 민 / 스 b ぢ 레 c와 ry-sets p /

내 환경에서는 https://운영이므로,
공통 설정도 있으므로, ↓이쪽의 파일에 추기했습니다.
VirtualHost 태그 중 가장 마지막에 추가했습니다.

vi /etc/apache2/sites-available/default-ssl.conf

/etc/apache2/sites-available/default-ssl.conf

<VirtualHost _default_:443>
－－－－－－－－－－－－－－－－－－－－－－－

    # BookStack Configuration
    Alias "/bookstack" "/var/www/bookstack/public"

    <Directory "/var/www/bookstack/public">
      Options FollowSymlinks
      AllowOverride None
      Require all granted

      RewriteEngine On
      # Redirect Trailing Slashes If Not A Folder...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteRule ^(.*)/$ /$1 [L,R=301]

      # Handle Front Controller...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteRule ^ index.php [L]
    </Directory>


    <Directory "/var/www/bookstack">
      AllowOverride None
      Require all denied
    </Directory>
    # End BookStack Configuration

－－－－－－－－－－－－－－－－－－－－－－－
　</VirtualHost>

다음 명령은 설정을 반영합니다.

sudo a2ensite default-ssl
apache2ctl configtest
sudo systemctl reload apache2

■ 기동 및 초기 설정

■ 무사히 부팅이 성공하면 이 화면이 표시됩니다.

초기 설정 로그인 이메일 주소 : 아 dmin @ 아 dmin. 이 m

초기 설정 패스워드:password
　
　에서 일단 로그인합니다.

■ 관리자 사용자의 로그인 설정을 즉시 변경합니다.

■ 무사히 로그인에 성공했습니다.

※/var/lib/bookstack/.env 파일의 설정을 잘못하지 않으면 큰 실패는 없다고 생각합니다.