bookstack 설치 [Apache Subdirectry 운영]

bookstack 설치 [Apache Subdirectry 운영]

2022-10-06 last update

5 minutes reading 우분투20.04 bookstack
설치 작업 노트 [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 파일의 설정을 잘못하지 않으면 큰 실패는 없다고 생각합니다.