为什么选择 Sonic

Sonic 是一个用 Go 编写的轻量级博客程序,二进制单文件部署,内置 SQLite 支持,对个人服务器非常友好。

相比 WordPress,它的资源占用低得多;相比静态博客,它又保留了后台管理、评论、搜索等动态能力。

部署前的准备

一台 1 核 1G 的云服务器就足够跑起来,建议准备好:

  • 一个可解析的域名
  • 服务器 80/443 端口
  • 一份 Nginx 配置

启动程序

下载对应平台的压缩包,解压后直接运行:

cd /opt/sonic
./sonic --config=conf/config.yaml

首次启动会自动创建 SQLite 数据库并完成初始化,随后访问 /admin 完成安装向导。

<script>
  // 公告
  (function() {
    new Marquee({
      // 要滚动的元素
      elem: document.getElementById("marquee2"),
      // 每次滚动的步长(px),默认0
      step: 30,
      // 滚动效果执行时间(ms),默认400
      stepInterval: 400,
      // 每次滚动间隔时间(ms),默认3000
      interval: 3000,
      // 滚动方向,up、down、left、right,默认为"left" 当前只支持上下
      dir: 'up',
      // 是否自动滚动,默认为true
      autoPlay: true,
      // 是否在鼠标滑过低级元素时暂停滚动,默认为true
      hoverPause: true
    });
  })();

  // 上传控制
  $('#upShowID').uploader({
    // 自动上传
    autoUpload: false,
    // 文件上传提交地址
    url: './app/upload.php',
    // 最大支持的上传文件
    max_file_size: <?php echo $config['maxSize']; ?>,
    // 分片上传 0为不分片 分片容易使图片上传失败
    chunk_size: <?php echo $config['chunks']; ?>,
    // 点击文件列表上传文件
    browseByClickList: true,
    // flash 上传组件地址
    flash_swf_url: '<?php static_cdn(); ?>/public/static/zui/lib/uploader/Moxie.swf',
    // silverlight 上传组件地址
    flash_swf_url: '<?php static_cdn(); ?>/public/static/zui/lib/uploader/Moxie.xap',
    // sign
    multipart_params: {
      'sign': new Date().getTime() / 1000 | 0,
    },
    // 预览图尺寸
    previewImageSize: {
      'width': 80,
      'height': 80
    },
    // 上传格式过滤
    filters: { // 只允许上传图片或图标(.ico)
      mime_types: [{
          title: '图片',
          extensions: '<?php echo $config['extensions']; ?>'
        },
        {
          title: '图标',
          extensions: 'ico'
        }
      ],
      prevent_duplicates: true
    },
    // 限制文件上传数目
    limitFilesCount: <?php echo $config['maxUploadFiles']; ?>,
    // 移除文件进行确认
    deleteConfirm: true,
    // 重置上传失败的文件
    autoResetFails: true,
    // 当文件上传进度发送变化时触发,此回调函数会在上传文件的过程中反复触发
    onUploadProgress: function(file) {
      NProgress.configure({
        barColor: '<?php echo $config['NProgress_Progress']; ?>'
      });
      NProgress.set(0)
      NProgress.set(file.percent / 100)
    },
    // 显示上传成功消息
    uploadedMessage: '已上传 {uploaded} 个文件,{failed} 个文件上传失败',
    // 当启用分片上传选项后,每个文件片段上传完成时触发
    onChunkUploaded: function(file, responseObject) {
      NProgress.set(responseObject.offset / responseObject.total);
    },
    <?php echo imgRatio(); ?>,
    responseHandler: function(responseObject, file) {
      var obj = JSON.parse(responseObject.response); //由JSON字符串转换为JSON对象
      console.log(file); // 输出上传log
      console.log(obj); // 输出回传log
      if (obj.code === 200) {
        $("#links").append(obj.url + "\r\n");
        $("#bbscode").append("[img]" + obj.url + "[/img]\r\n");
        $("#markdown").append("![" + obj.srcName + "](" + obj.url + ")\r\n");
        $("#html").append('&lt;img src="' + obj.url + '" alt="' + obj.srcName + '" /&gt;\r\n');
        $("#thumb").append(obj.thumb + "\r\n");
        $("#del").append(obj.del + "\r\n");

        // 上传成功提示
        new $.zui.Messager(obj.srcName + " 上传成功", {
          type: "primary",
          placement: 'bottom-right',
          icon: "check"
        }).show();

        try { // 储存上传历史
          console.log('history localStorage success');
          $.zui.store.set(obj.srcName, obj)
        } catch (err) {
          // 失败提示
          $.zui.messager.show('存储上传记录失败' + err, {
            icon: 'bell',
            time: 4000,
            type: 'danger',
            placement: 'top'
          });
          console.log('localStorage failed:' + err);
        }
      } else {
        // 上传失败提示
        new $.zui.Messager(obj.message, {
          type: "danger",
          placement: 'bottom-right',
          icon: "times"
        }).show();
        return;
      }
    },
  });
</script>

反向代理配置

server {
    listen 80;
    server_name blog.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

常见问题

现象 原因 处理方式
后台打不开 未完成安装 访问 /admin 走安装向导
图片 404 上传目录权限 检查 upload 目录可写
样式丢失 静态资源路径 检查主题 theme_base

部署过程中最容易忽略的是上传目录的写权限,容器化部署时尤其要注意挂载。

小结

整套流程走下来,从下载到上线大约 20 分钟,后续只需要专注于写作本身。